描述
EnumPrintProcessors功能列举了指定服务器上安装的打印处理器。
C++ 语法
BOOL EnumPrintProcessors( __in LPTSTR pName, __in LPTSTR pEnvironment, __in DWORD Level, __out LPBYTE pPrintProcessorInfo, __in DWORD cbBuf, __out LPDWORD pcbNeeded, __out LPDWORD pcReturned ); |
PowerBASIC 语法
FUNCTION EnumPrintProcessorsA ( _ BYREF pName AS ASCIIZ, _ BYREF pEnvironment AS ASCIIZ, _ BYVAL Level AS DWORD, _ BYREF pPrintProcessorInfo AS ANY, _ BYVAL cbBuf AS DWORD, _ BYREF pcbNeeded AS DWORD, _ BYREF pcReturned AS DWORD _ ) AS LONG |
Unicode版本:
FUNCTION EnumPrintProcessorsW ( _ BYREF pName AS WSTRINGZ, _ BYREF pEnvironment AS WSTRINGZ, _ BYVAL Level AS DWORD, _ BYREF pPrintProcessorInfo AS ANY, _ BYVAL cbBuf AS DWORD, _ BYREF pcbNeeded AS DWORD, _ BYREF pcReturned AS DWORD _ ) AS LONG |
参数
pName
[in]指向指定打印处理器所在服务器的名称的以空值终止的字符串的指针。如果此参数为NULL，则枚举本地打印处理器。
pEnvironment
[in]指向指定环境的空终止字符串的指针（例如，Windows NT x86，Windows IA64，Windows x64，Windows NT R4000，Windows NT Alpha_AXP，Windows 4.0或Windows NT PowerPC）。如果此参数为NULL，则使用调用应用程序和客户机（而不是目标应用程序和打印服务器）的当前环境。
注意 Windows IA64在Windows XP，Windows XP 64位版，Windows Server 2003和更高版本中可用。Windows XP Service Pack 2（SP2），Windows XP Professional x64 Edition，Windows Server 2003 Service Pack 1（SP1）和更高版本中提供Windows x64。
Level
[in]指定pPrintProcessorInfo缓冲区中返回的信息类型。此参数必须为1。
pPrintProcessorInfo
[out]指向接收PRINTPROCESSOR_INFO_1结构数组的缓冲区的指针。每个结构描述了可用的打印处理器。缓冲区必须足够大以接收结构数组和结构成员指向的任何字符串。
要确定所需的缓冲区大小，请将cbBuf设为零。EnumPrintProcessors失败，GetLastError返回ERROR_INSUFFICIENT_BUFFER，pcbNeeded参数返回保存结构数组及其数据所需的缓冲区大小（以字节为单位）。
cbBuf
[in]指定pPrintProcessorInfo指向的缓冲区的大小（以字节为单位）。
pcbNeeded
[out]指向变量的指针，如果函数成功，则可以接收复制到pPrintProcessorInfo缓冲区的字节数。如果缓冲区太小，则该函数失败，变量接收所需的字节数。
pcReturned
[out]指向接收pPrintProcessorInfo缓冲区中返回的结构数的变量的指针。
返回值
如果函数成功，则返回值为非零值。
如果函数失败，返回值为零。
引用文件 #INCLUDE Once
WinSpool.inc（包括Windows.inc）