Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                     ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
WORD WNetHoldJob(szQueue, wJobID)
LPSTR szQueue;
WORD wJobID;
 
The WNetHoldJob function attempts to hold a previously spooled network job.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
szQueue    Points to a null-terminated string specifying the name of the
           print queue.
 
wJobID     Specifies the job identifier.
 
Return Value
 
The return value is one of the following values.
 
Value             Meaning
────────────────────────────────────────────────────────────────────────────
WN_ACCESS_DENIED  Security violation.
 
WN_BAD_JOBID      Job ID is invalid.
 
WN_BAD_POINTER    Invalid pointer.
 
WN_BAD_QUEUE      The szQueue parameter is not a valid net queue or
                  redirected device.
 
WN_JOB_NOT_FOUND  No job with this ID found on this queue.
 
WN_NET_ERROR      Network error.
 
WN_NOT_SUPPORTED  Function not supported.
 
WN_OUT_OF_MEMORY  Out of memory.
 
WN_SUCCESS        Success.
 
Comments
 
The export ordinal for this function is 4.
 
The exact effect depends upon the network. In most cases, the held job will
continue to move up in the queue until it is ready to print. However, it
will then not be allowed to print and will sit with the queue number of 1,
while other jobs move around it and are printed. This will last until the
job is released using the WNetReleaseJob function.
 
See Also
 
WNetOpenJob, WNetReleaseJob
 
 
                                      ♦