GetPrinterDriver 函数

  • 项目

GetPrinterDriver 函数检索指定打印机的驱动程序数据。 如果本地计算机上未安装驱动程序， 则 GetPrinterDriver 将安装它。

语法

BOOL GetPrinterDriver(
  _In_  HANDLE  hPrinter,
  _In_  LPTSTR  pEnvironment,
  _In_  DWORD   Level,
  _Out_ LPBYTE  pDriverInfo,
  _In_  DWORD   cbBuf,
  _Out_ LPDWORD pcbNeeded
);

参数

hPrinter [in]

应为其检索驱动程序数据的打印机的句柄。 使用 OpenPrinter 或 AddPrinter 函数检索打印机句柄。

pEnvironment [in]

指向以 null 结尾的字符串的指针，该字符串指定环境 (，例如 Windows x86、Windows IA64 或 Windows x64) 。 如果此参数为 NULL，则使用调用应用程序和客户端计算机的当前环境 (目标应用程序和打印服务器) 。

级别 [in]

pDriverInfo 缓冲区中返回的打印机驱动程序结构。 此参数的取值可为下列值之一：

值 含义
1
 DRIVER_INFO_1
2
 DRIVER_INFO_2
3
 DRIVER_INFO_3
4
 DRIVER_INFO_4
5
 DRIVER_INFO_5
6
 DRIVER_INFO_6
8
 DRIVER_INFO_8

pDriverInfo [out]

指向缓冲区的指针，该缓冲区接收包含有关驱动程序的信息（由 Level 指定）的结构。 缓冲区必须足够大，才能存储结构成员指向的字符串。

若要确定所需的缓冲区大小，请调用将 cbBuf 设置为零的 GetPrinterDriver。 GetPrinterDriver 失败， GetLastError 返回ERROR_INSUFFICIENT_BUFFER， 而ERROR_INSUFFICIENT_BUFFER，而ERROR_INSUFFICIENT_BUFFER，而ERROR_INSUFFICIENT_BUFFER 参数返回保存结构数组及其数据所需的缓冲区大小（以字节为单位）。

cbBuf [in]

pDriverInfo 指向的数组的大小（以字节为单位）。

线路板 [out]

指向一个值的指针，该值接收在函数成功时复制的字节数;如果 cbBuf 太小，则接收所需的字节数。

返回值

如果函数成功，则返回值为非零值。

如果函数失败，则返回值为零。

对于不存在的驱动程序，函数返回ERROR_UNKNOWN_PRINTER_DRIVER。

备注

注意

这是一个阻塞或同步函数，可能不会立即返回。 此函数的返回速度取决于运行时因素，例如网络状态、打印服务器配置以及编写应用程序时难以预测的打印机驱动程序实现因素。 从管理与用户界面交互的线程调用此函数可能会使应用程序看起来无响应。

DRIVER_INFO_2、DRIVER_INFO_3、DRIVER_INFO_4、DRIVER_INFO_5和DRIVER_INFO_6结构包含 pDriverPath 成员中打印机驱动程序的文件名或完整路径和文件名。 应用程序可以使用路径和文件名来加载打印机驱动程序，方法是调用 LoadLibrary 函数，并将路径和文件名作为单个参数提供。

要求

要求 值
最低受支持的客户端
 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
 Windows 2000 Server [仅限桌面应用]
标头
Winspool.h (包括 Windows.h)
库
Winspool.lib
DLL
Winspool.drv
Unicode 和 ANSI 名称
 GetPrinterDriverW (Unicode) 和 GetPrinterDriverA (ANSI)

另请参阅

打印

打印后台处理程序 API 函数

AddPrinterDriver

DRIVER_INFO_1

DRIVER_INFO_2

DRIVER_INFO_3

DRIVER_INFO_4

DRIVER_INFO_5

DRIVER_INFO_6

EnumPrinterDrivers

OpenPrinter