SplEnumDevice - Parameters

pszComputerName (PSZ) - input

Name of computer where print devices are to. be listed.

A NULL string specifies the local workstation.

ulLevel (ULONG) - input

Level of detail required.

This must be 0, 2 or 3.

pBuf (PVOID) - output

Buffer.

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

ulLevel

Buffer Contents
0
An array of port names. Each name consists of 9 characters, including a null terminator.
2
An array of print device names of type PSZ.
3
An array of PRDINFO3 structures.
If no job is printing on the print device, bits 2-11 of fsStatus in the PRDINFO3 data structure are meaningless.

cbBuf (ULONG) - input

Size, in bytes, of Buffer.

It must be greater than 0.

pcReturned (PULONG) - output

Number of entries returned.

pcTotal (PULONG) - output

Number of entries available.

pcbNeeded (PULONG) - output

Size in bytes of available information.

A value of 0 specifies that the size is not known.

pReserved (PVOID) - output

Reserved value, must be NULL.

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_InvalidComputer (2351)
The computer name is invalid.

---

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