DosPFSCloseUser

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:

• 8 Attempted to close system file number not active.
• 9 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