NWPSPdfLocateDBAndSetContext(3nw)
NWPSPdfLocateDBAndSetContext --
sets context to OU or O in directory with pre-existing database
Synopsis
#include <nwps_pdf.h>
or
#include <nwpsrv.h>
NWCCODE NWAPI NWPSPdfLocateDBAndSetContext
(DWORD contextID,
char NWFAR
printerOrQueueObjectName);
Description
- contextID
-
(IN/OUT) Specifies the Directory context handle.
- printerOrQueueObjectName
-
(IN) Points to the starting point for the search.
Return values
- 0x0000
-
Successful
- -1
-
General Error
- other
-
Bindery or Directory Services Errors
Notices
NWPSPdfLocateDBAndSetContext searches the Directory toward the
root using the given printer or print queue object name.
Prior to making other Printer Definition calls,
NWPSPdfLocateDBAndSetContext is used to establish which database
to refer to with respect to a particular queue or printer. This is important
in applications with functions similar to NPrint and
Capture. The PrintDef utility does not call
NWPSPdfLocateDBAndSetContext.
Services
Print Server
NCP calls
None
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.