NWPSPdfReadFunction(3nw)


NWPSPdfReadFunction -- reads function definition in PRINTDEF

Synopsis

   #include <nwps_pdf.h> 
   or 
   #include <nwpsrv.h> 
   

NWCCODE NWAPI NWPSPdfReadFunction (WORD connType, DWORD connID, char NWFAR *deviceName, char NWFAR *funcName, WORD funcOffset, WORD NWFAR *funcSize, BYTE NWFAR *funcString);

Description

The parameters are as follows:

connType
(IN) Specifies either NWPS_BINDERY_SERVICE, NWPS_BINDERY_SERVICE_PRE_40, or NWPS_DIRECTORY_SERVICE.

connID
(IN) Specifies the connection or context identifier.

deviceName
(IN) Points to the associated device name.

funcName
(IN) Points to the name of the function to read.

funcOffset
(IN) Specifies the starting offset or number of entries to skip past.

funcSize
(IN/OUT) Points to the buffer size of funcString upon input. Points to the actual number of bytes read upon output.

funcString
(OUT) Points to the buffer where the string is stored.

Return values

0x0000
Successful

-1
General Error

other
Bindery or Directory Services Errors

Notices

Functions can be up to 64KB and may need to be read in segments.

funcSize should be set to the length of the funcString buffer. If NWPSPdfReadFunction is successful, funcSize contains the number of bytes copied to the funcString buffer. When no bytes are left in the database, a -1 is returned or funcSize is zero.

Services

Print Server

References

NWPSPdfAddDevice(3nw), NWPSPdfAddFunction(3nw), NWPSPdfDeleteFunction(3nw), NWPSPdfReadModeFunction(3nw), NWPSPdfUpdateFunction(3nw), NWCCOpenConnByName(3nw), NWDSCreateContext(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.