SplQueryDevice - Parameters

pszComputerName (PSZ) - input

Name of computer where print device is to be queried.

A NULL string specifies the local workstation.

pszPrintDeviceName (PSZ) - input

Name of Print Device.

This can specify a print device name or a port name. If ulLevel is 0, it must be a port name. If ulLevel is 2 or 3, it must be a print device name.

ulLevel (ULONG) - input

Level of detail required.

This must be 0, 2 or 3.

pBuf (PVOID) - in/out

Buffer.

The returned contents of the buffer depend on the value specified in ulLevel as follows:

ulLevel

Buffer Contents
0
A port name consisting of 9 characters, including a null terminator.
2
A print device name of type PSZ.
3
A PRDINFO3 structure.

cbBuf (ULONG) - input

Size, in bytes, of Buffer.

It must be greater than 0.

pcbNeeded (PULONG) - output

Size in bytes of available information.

rc (SPLERR) - returns

Return code.

NO_ERROR (0)

No errors occurred.
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.
ERROR_MORE_DATA (234)
Additional data is available.
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_InvalidComputer (2351)
The computer name is invalid.

---

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