SplSetJob - 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.

---

[Back: SplSetJob Return Value - rc]
[Next: SplSetJob - Remarks]