EngGetPrinter 函数 (winddi.h)
EngGetPrinter 函数检索有关指定打印机的信息。
语法
ENGAPI BOOL EngGetPrinter(
[in] HANDLE hPrinter,
[in] DWORD dwLevel,
[out, optional] LPBYTE pPrinter,
[in] DWORD cbBuf,
[out] LPDWORD pcbNeeded
);
参数
[in] hPrinter
应为其检索数据的打印机的句柄。 这是作为 DrvEnablePDEV 的 hDriver 参数传递的句柄。
[in] dwLevel
指定 pPrinter 指向的结构的版本。 此参数可能具有以下任何值:
值 | 通过 pPrinter 返回的结构 |
---|---|
1 | PRINTER_INFO_1 |
2 | PRINTER_INFO_2 |
3 | PRINTER_INFO_3 |
4 | PRINTER_INFO_4 |
5 | PRINTER_INFO_5 |
[out, optional] pPrinter
指向内存缓冲区的指针,其中加载了 由 dwLevel 标识的打印机信息结构。
[in] cbBuf
指定 pPrinter 指向的内存缓冲区的大小(以字节为单位)。
[out] pcbNeeded
指向内存位置的指针,该位置接收函数成功时复制的字节数;如果 cbBuf 太小,则接收所需字节数。
返回值
成功后,EngGetPrinter 返回 TRUE ;否则,它会记录错误并返回 FALSE。 若要获取错误信息,请调用 EngGetLastError。
注解
PRINTER_INFO_X 结构在 Microsoft Windows SDK 文档中定义。
要求
最低受支持的客户端 | 在 Windows 2000 及更高版本的 Windows 操作系统中可用。 |
目标平台 | 通用 |
标头 | winddi.h (包括 Winddi.h) |
Library | Win32k.lib |
DLL | Win32k.sys |