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.