NWPSPdfImportDevice(3nw)


NWPSPdfImportDevice -- imports device from .PDF file to database

Synopsis

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

NWCCODE NWAPI NWPSPdfImportDevice (WORD connType, DWORD connID, char NWFAR *fileName, char NWFAR *deviceName);

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.

fileName
(IN) Points to the name of the .PDF file.

deviceName
(IN/OUT) Points to an empty string upon input. Points to the device to import upon output. Its maximum length is NWPS_DEVI_NAME_SIZE + 1.

Return values

0x0000
NWPSE_SUCCESSFUL

0x7774
NWPSE_ERROR_OPENING_DB

0x7775
NWPSE_ERROR_READING_DB

0x89EE
OBJECT_ALREADY_EXISTS

Notices

The fileName should be in one of the following forms:
   \\file servervolumepathfile name[.PDF] volume:pathfile name[.PDF] 
If fileName is NULL, the file device name[.PDF] is created in the local directory.

deviceName changes the name of an import device in cases when it may conflict with an existing device and returns the imported device name to the caller.

When deviceName is NULL, use the name in the .PDF file. If it is an empty string, use the name in the .PDF file, but return the imported name to the user. If it is a new name, use the specified name instead of the name in the .PDF file.

If OBJECT_ALREADY_EXISTS returns, pass in a string to deviceName not already in use.

Every .PDF import file also has a date code associated with it. The date is always set when the file is created. See NWPSPdfSetImportDate(3nw) and NWPSPdfGetImportDate(3nw).

Services

Print Server

References

NWPSPdfExportDevice(3nw), NWPSPdfGetImportDate(3nw), NWPSPdfSetImportDate(3nw), NWCCOpenConnByName(3nw), NWDSCreateContext(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.