EnumPrintProcessors
The EnumPrintProcessors
function enumerates the print processors installed on the specified server.
BOOL EnumPrintProcessors(
|
LPTSTR pName, |
// points to server
name |
|
LPTSTR pEnvironment, |
// points to
environment name |
|
DWORD Level, |
// structure level |
|
LPBYTE pPrintProcessorInfo, |
// points to
structure array |
|
DWORD cbBuf, |
// array length in
bytes |
|
LPDWORD pcbNeeded, |
// points to number
of bytes copied (or required) |
|
LPDWORD pcReturned |
// points to number
of job info. structures copied |
|
); |
|
Parameters
pName
Points to a
null-terminated string that specifies the name of the server on which the print
processors reside. If this parameter is NULL, the local print processors are
enumerated.
pEnvironment
Points to a
null-terminated string that specifies the environment. For example, Windows NT
x86 specifies Windows NT running on an Intel 80386 or 80486 processor. If this
parameter is NULL, the current environment of the calling application and
client machine (not of the destination application and print server) is used.
Level
Specifies the
version of the structure to which pPrintProcessorInfo points. This value
must be 1.
pPrintProcessorInfo
Points to an
array of PRINTPROCESSOR_INFO_1 structures. One structure is created for each available
print processor.
cbBuf
Specifies the
size, in bytes, of the buffer pointed to by pPrintProcessorInfo.
pcbNeeded
Points to a
value that specifies the number of bytes copied if the function succeeds or the
number of bytes required if cbBuf is too small.
pcReturned
Points to a
value that specifies the number of PRINTPROCESSOR_INFO_1 structures that
returned in the array to which pPrintProcessorInfo points.
Return Values
If the
function succeeds, the return value is nonzero.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
See Also