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
AddPrintProcessor, EnumPrintProcessorDatatypes, PRINTPROCESSOR_INFO_1