SplQueryQueue - Parameters

pszComputerName (PSZ) - input

Name of computer where queue is to be queried.

A NULL string specifies the local workstation.

pszQueueName (PSZ) - input

Queue name.

ulLevel (ULONG) - input

Level of detail required.

This must be 3, 4, 5, 6 or 7.

pBuf (PVOID) - in/out

Buffer.

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

ulLevel

Buffer Contents
3
A PRQINFO3 structure, with associated variable information up to cbBuf. The fsType bit PRQ3_TYPE_APPDEFAULT is set for the application default queue only.
4
A PRQINFO3 structure, with associated variable information, and an array of PRJINFO2 structures, one for each job in the queue, up to cbBuf.
5
A queue name of type PSZ.
6
A PRQINFO6 structure, with associated variable information up to cbBuf.
7
A PRQINFO3 structure, with associated variable information, and an array of PRJINFO4 structures, one for each job in the queue, up to cbBuf.

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_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.
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_QNotFound (2150)
The printer queue does not exist.
NERR_InvalidComputer (2351)
The computer name is invalid.

---

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