平台 SDK: Windows GDI

EnumForms

EnumForms函数枚举指定打印机支持的表单。

BOOL EnumForms(
  HANDLE hPrinter,    // 打印机对象句柄
  DWORD Level,        // 数据级别
  LPBYTE pForm,       // 形成信息缓冲区
  DWORD cbBuf,        // 表单信息缓冲区的大小
  LPDWORD pcbNeeded,  // 接收或需要的字节
  LPDWORD pcReturned  // 收到的表格数量
);

参数

  • hPrinter

  • [in] 应列举表单的打印机句柄。 使用OpenPrinter或AddPrinter函数检索打印机句柄。

  • Level

  • [in] 指定pForm指向的结构版本。 该值必须是1。

  • pForm

  • [out] 指向FORM_INFO_1结构的指针。

  • cbBuf

  • [in] 指定pForm指向的缓冲区的大小(以字节为单位)。

  • pcbNeeded

  • [out] 指向一个变量的指针,该变量接收复制到的字节数或pForm指向的数组所需的字节数。 如果cbBuf太小,则此值指定所需的字节数; 否则,此值指定复制的字节数。

  • pcReturned

  • [out] 指向一个变量的指针,该变量接收复制到pForm指向的数组中的FORM_INFO_1结构数。

返回值

如果函数成功,则返回值是非零值。

如果函数失败,返回值为零。 要获得扩展的错误信息,请调用GetLastError。

要求

  Windows NT/2000/XP: 包含在Windows NT 3.51和更高版本中。

  Windows 95/98/Me: 不支持。

  头文件: 声明于 Winspool.h; 包含于 Windows.h.
  库: 使用 Winspool.lib.

  Unicode: 实现为Unicode和ANSI版本。