SplSetJob
This function modifies the instructions for a print job.
Syntax
SplSetJob(pszComputerName, pszQueueName, ulJob, ulLevel, pBuf, cbBuf, ulParmNum)
Parameters
- pszComputerName (PSZ) - input
- Name of computer where job is to be modified.
- A NULL string specifies the local workstation.
- pszQueueName (PSZ) - input
- Queue Name.
- ulJob (ULONG) - input
- Job identification number.
- ulLevel (ULONG) - input
- Level of detail required.
- This must be 3.
- pBuf (PVOID) - input
- Buffer.
- If ulParmNum is 0, this parameter must contain a complete PRJINFO3 structure. Otherwise,it must contain a valid new value for the parameter of the PRJINFO3 structure. indicated in ulParmNum
- cbBuf (ULONG) - input
- Size, in bytes, of Buffer.
- It must be greater than 0.
- ulParmNum (ULONG) - input
- Parameter number.
- Specifies either that the entire PRJINFO3 structure is to be modified, or that only one specific parameter is to be modified.
- If ulParmNum is 0, pBuf must contain a complete PRJINFO3 structure. Otherwise, pBuf must contain a new valid value for the parameter to be modified. The following are the possible values for this parameter:
Parameter Value pszNotifyName PRJ_NOTIFYNAME_PARMNUM (3) pszDataType PRJ_DATATYPE_PARMNUM (4) pszParms PRJ_PARMS_PARMNUM (5) uPosition PRJ_POSITION_PARMNUM (6) pszComment PRJ_COMMENT_PARMNUM (11) pszDocument PRJ_DOCUMENT_PARMNUM (12) pszStatus PRJ_STATUSCOMMENT_PARMNUM (13) uPriority PRJ_PRIORITY_PARMNUM (14) pszQProcParms PRJ_PROCPARMS_PARMNUM (16) pDriverData PRJ_DRIVERDATA_PARMNUM (18)
- uPosition must be given the appropriate value, as follows:
Value Change 0 No change 1 Move to first place >1 Move to this position, or if the specified value is greater than the number of jobs in the queue, move to the end of the queue.
- rc (SPLERR) - returns
- Return code.
- NO_ERROR (0) No errors occurred.
- ERROR_ACCESS_DENIED (5) Access is denied.
- ERROR_NOT_SUPPORTED (50) This request is not supported by the network.
- ERROR_BAD_NETPATH (53) The network path cannot be located.
- ERROR_INVALID_PARAMETER (87) An invalid parameter is specified.
- ERROR_INVALID_LEVEL (124) The level parameter is invalid.
- NERR_NetNotStarted (2102) The network program is not started.
- NERR_BufTooSmall (2123) The API return buffer is too small.
- NERR_JobNotFound (2151) The print job does not exist.
- NERR_SpoolerNotLoaded (2161) The spooler is not running.
- NERR_JobInvalidState (2164) This operation cannot be performed on the print job in its current state.
- NERR_SpoolNoMemory (2165) A spooler memory allocation failure occurred.
- NERR_DriverNotFound (2166) The device driver does not exist.
- NERR_ProcNotFound (2168) The queue processor is not installed.
- NERR_InvalidComputer (2351) The computer name is invalid.