| WORD WNetHoldJob(szQueue, wJobID) | |||
| LPSTR szQueue; | |||
| WORD wJobID; |
The WNetHoldJob function attempts to hold a previously spooled network job.
szQueue
Points to a null-terminated string specifying the name of the print queue.
wJobID
Specifies the job identifier.
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. |
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.