SplSetDevice - Parameters

pszComputerName (PSZ) - input

Name of computer where print device is to be modified.

A NULL string specifies the local workstation.

pszPrintDeviceName (PSZ) - input

Name of Print Device.

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 grater than 0.

ulParmNum (ULONG) - input

Parameter number.

Specifies either that the entire PRDINFO3 structure is to be modified, or only one specific parameter is to be modified.

If ulParmNum is 0, pBuf must contain a complete PRDINFO3 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

Constant (Value)
pszLogAddr
PRD_LOGADDR_PARMNUM (3)
pszComment
PRD_COMMENT_PARMNUM (7)
pszDrivers
PRD_DRIVERS_PARMNUM (8)
usTimeOut
PRD_TIMEOUT_PARMNUM (10)

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_DestNotFound (2152)
The print device cannot be found.
NERR_DestInvalidState (2162)
This operation cannot be performed on the print device.
NERR_SpoolNoMemory (2165)
A spooler memory allocation failure occurred.
NERR_DriverNotFound (2166)
The device driver does not exist.
NERR_BadDev (2341)
The requested device is invalid.
NERR_InvalidComputer (2351)
The computer name is invalid.

---

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