DosPFSCloseUser: Difference between revisions
No edit summary |
mNo edit summary |
||
| Line 1: | Line 1: | ||
This call indicates to the Font Switcher that the specified process has closed its spool file. The Font Switcher may then free any resources being used to track code page and font switching for a process. | This call indicates to the Font Switcher that the specified process has closed its spool file. The Font Switcher may then free any resources being used to track code page and font switching for a process. | ||
| Line 14: | Line 10: | ||
==Return Code== | ==Return Code== | ||
;rc (USHORT) - return:Return values are: | |||
Return values are: | |||
* Attempted to close system file number not active. | * Attempted to close system file number not active. | ||
* Code page switcher internal error. | * Code page switcher internal error. | ||
* 10 | *10 Invalid printer name as input. | ||
* 13 | *13 Received code page request when code page switcher not initialized. | ||
==Remarks== | ==Remarks== | ||
DosPFSCloseUser is intended for use only by applications that replace the spooler as a print monitor and that do code page switching. Other applications should use printer IOCTLs to manipulate printer code page switching. | DosPFSCloseUser is intended for use only by applications that replace the spooler as a print monitor and that do code page switching. Other applications should use printer IOCTLs to manipulate printer code page switching. | ||
DosPFSCloseUser is located in SPOOLCP.DLL (not in DOSCALLS.LIB) and requires an import statement in the module definition file. Refer to the IBM Operating System/2 Version 1.2 Building Programs, Module Definition File Statements section for information regarding the import statement. | DosPFSCloseUser is located in SPOOLCP.DLL (not in DOSCALLS.LIB) and requires an import statement in the module definition file. Refer to the ''IBM Operating System/2 Version 1.2 Building Programs'', Module Definition File Statements section for information regarding the import statement. | ||
== | ==Bindings== | ||
===C | ===C=== | ||
<PRE> | <PRE> | ||
#define INCL_DOSPFS | #define INCL_DOSPFS | ||
| Line 33: | Line 28: | ||
USHORT rc = DosPFSCloseUser(PrinterName, SFN, Reserved); | USHORT rc = DosPFSCloseUser(PrinterName, SFN, Reserved); | ||
PSZ | PSZ PrinterName; /* Printer name string */ | ||
USHORT | USHORT SFN; /* System File Number */ | ||
ULONG | ULONG 0; /* Reserved, set to zero */ | ||
USHORT | USHORT rc; /* return code */ | ||
</PRE> | </PRE> | ||
===MASM | ===MASM=== | ||
<PRE> | <PRE> | ||
EXTRN DosPFSCloseUser:FAR | EXTRN DosPFSCloseUser:FAR | ||
| Line 52: | Line 47: | ||
Returns WORD | Returns WORD | ||
</PRE> | </PRE> | ||
[[Category:Dos]] | [[Category:Dos]] | ||
Revision as of 10:40, 24 November 2019
This call indicates to the Font Switcher that the specified process has closed its spool file. The Font Switcher may then free any resources being used to track code page and font switching for a process.
Syntax
DosPFSCloseUser (PrinterName, SFN, Reserved)
Parameters
- PrinterName (PSZ) - input
- Address of the name of the printer that closes code page and font switching.
- SFN (USHORT) - input
- System File Number of the requester. The SFN is passed as a parameter in the monitor packet.
- Reserved (ULONG) - input
- Reserved must be set to zero.
Return Code
- rc (USHORT) - return
- Return values are:
- Attempted to close system file number not active.
- Code page switcher internal error.
- 10 Invalid printer name as input.
- 13 Received code page request when code page switcher not initialized.
Remarks
DosPFSCloseUser is intended for use only by applications that replace the spooler as a print monitor and that do code page switching. Other applications should use printer IOCTLs to manipulate printer code page switching.
DosPFSCloseUser is located in SPOOLCP.DLL (not in DOSCALLS.LIB) and requires an import statement in the module definition file. Refer to the IBM Operating System/2 Version 1.2 Building Programs, Module Definition File Statements section for information regarding the import statement.
Bindings
C
#define INCL_DOSPFS USHORT rc = DosPFSCloseUser(PrinterName, SFN, Reserved); PSZ PrinterName; /* Printer name string */ USHORT SFN; /* System File Number */ ULONG 0; /* Reserved, set to zero */ USHORT rc; /* return code */
MASM
EXTRN DosPFSCloseUser:FAR INCL_DOSPFS EQU 1 PUSH@ ASCIIZ PrinterName ;Printer name string PUSH WORD SFN ;System File Number PUSH DWORD 0 ;Reserved (must be zero) CALL DosPFSCloseUser Returns WORD