## Presentation Device Driver Reference for OS/2

[prev][next][parent][TOC]

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