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 WNetSetJobCopies(szQueue, wJobID, nCopies)
LPSTR szQueue;
WORD wJobID;
WORD nCopies;
 
The WNetSetJobCopies function attempts to change the number of copies of a
previously spooled job.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
szQueue    Points to a null-terminated string specifying the name of the
           print queue.
 
wJobID     Specifies the job identifier.
 
nCopies    Specifies the number of copies to print. If the number is zero,
           the function will return an error code and will have no effect.
           If the number is too great for the queue to support, the number
           is changed to the largest one possible.
 
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_BAD_VALUE      Invalid number of copies.
 
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 7.
 
See Also
 
WNetOpenJob
 
 
                                      ♦