SplQueryPort
This function queries information about a printer port.
Syntax
SplQueryPort(pszComputerName, pszPortName,
ulLevel, pBuf, cbBuf, pcbNeeded)
Parameters
- pszComputerName (PSZ) - input
- Name of the computer connected to the port.
- This value can be NULL for a local machine.
- pszPortName (PSZ) - input
- Name of the port to query.
- ulLevel (ULONG) - input
- Level of information to return.
- This must be 2.
- pBuf (PVOID) - output
- Receives the PRPORTINFO2 data structure.
- See PRPORTINFO2 in Data Types for details on this data structure.
- cbBuf (ULONG) - input
- Length of buffer pointed to by pBuf, in bytes.
- pcbNeeded (PULONG) - output
- Receives length, in bytes, of buffer needed to return all the port data.
Returns
- rc (ULONG) - returns
- Return codes.
- 0 Success
- 50 ERROR_NOT_SUPPORTED - Command not supported on pszComputerName.
- 87 ERROR_INVALID_PARAMETER - An invalid parameter was specified; most likely an invalid pBuf value.
- 124 ERROR_INVALID_LEVEL - ulLevel is not 2.
- 234 ERROR_MORE_DATA - Not all data could fit in pBuf.
- 2123 NERR_BufTooSmall - No data could fit in pBuf.
- 2152 NERR_DestNotFound - The port name does not exist.