NWGetPrinterStrings(3nw)


NWGetPrinterStrings -- returns printer setup and reset strings

Synopsis

   #include <nwprint.h> 
   or 
   #include <nwcalls.h> 
   

NWCCODE NWAPI NWGetPrinterStrings (nuint8 LPTDevice, pnuint16 setupStringLen, pnstr8 setupString, pnuint16 resetStringLen, pnstr8 resetString);

Description

The parameters are as follows:

LPTDevice
(IN) Specifies the number of the specified LPT device.

setupStringLen
(IN/OUT) Points to the length of the buffer setupString upon input. Points to the length of the actual setupString returned (optional) upon output.

setupString
(OUT) Points to a buffer in which to put setupString (optional).

resetStringLen
(IN/OUT) Points to the length of the buffer resetString upon input. Points to the length of the actual resetString returned (optional).

resetString
(OUT) Points to a buffer in which to put resetString (optional).

Return values

0x0000
SUCCESSFUL

Notices

A buffer the size of setupStringMaxLen and resetStringMaxLen(fields in NWCAPTURE_FLAGS2) must be provided for NWGetPrinterStrings. These lengths can be retrieved by calling NWGetCaptureFlags. The actual string lengths are returned in setupStringLen and resetStringLen. The strings are not NULL-terminated and may contain NULLs.

If set to NULL, setupString is not filled and no value is returned in setupStringLen. If set to NULL, resetString is not filled and no value is returned in resetStringLen.

Under Netx, LPTDevice can have the following values:

1
LPT1

2
LPT2

3
LPT3
Under VLM and OS/2, LPTDevice can have up to nine values (1-9).

Services

Print

NCP calls

0x2222 17 06 Get Printer Status

 
 0x2222   17   06   Get Printer Status 

References

NWSetPrinterStrings(3nw), NWGetCaptureFlags(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.