NWStartQueueCapture(3nw)


NWStartQueueCapture -- redirects device to queue

Synopsis

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

NWCCODE NWAPI NWStartQueueCapture (NWCONN_HANDLE conn, nuint8 LPTDevice, nuint32 queueID, pnstr8 queueName);

Description

The parameters are as follows:

conn
(IN) Specifies the NetWare server connection handle.

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

queueID
(IN) Specifies the bindery object ID of the print queue on the target server.

queueName
(IN) Points to the object name of the print queue (up to 65 characters) or NULL.

Return values

0x0000
SUCCESSFUL

Notices

Call NWStartQueueCapture to change the current capture information values.

When trying to capture to a different server, ensure you pass in the connection handle for the server to whose queue you want to attach. Otherwise, NWStartQueueCapture will return an error that the queue is unknown.

When an application sends data to the captured LPT device, the workstation shell traps the data and redirects it to a capture file on a NetWare server.

The NetWare server creates the capture file and an associated print queue job number when the first character is sent to the redirected LPT device. The NetWare server also places a hold on the print queue job number while data is captured to the file. Once the application closes the capture file with NWEndCapture or NWFlushCapture, a printer servicing the queue can print the file.

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 23 17 Get File Server Information
0x2222 23 102 Read Queue Current Status
0x2222 23 125 Read Queue Current Status

 
 0x2222   23   17    Get File Server Information 
 0x2222   23   102   Read Queue Current Status 
 0x2222   23   125   Read Queue Current Status 

30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.