ConnectToPrinterDlg 函数

ConnectToPrinterDlg 函数显示一个对话框，允许用户浏览和连接到网络上的打印机。 如果用户选择打印机，该函数将尝试创建与打印机的连接;如果未在服务器上安装合适的驱动程序，则为用户提供在本地创建打印机的选项。

语法

HANDLE ConnectToPrinterDlg(
  _In_ HWND  hwnd,
  _In_ DWORD Flags
);

参数

hwnd [in]

指定对话框的父窗口。

Flags [in]

此参数是保留的，必须为零。

返回值

如果函数成功，并且用户选择了打印机，则返回值是所选打印机的句柄。

如果函数失败，或者用户取消对话框而不选择打印机，则返回值为 NULL。

备注

注意

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

ConnectToPrinterDlg 函数尝试创建与所选打印机的连接。 但是，如果打印机所在的服务器未安装合适的驱动程序，则 函数将为用户提供在本地创建打印机的选项。 调用应用程序可以通过使用 PRINTER_INFO_2 结构调用 GetPrinter，然后检查该结构的 Attributes 成员，来确定函数是否在本地创建了打印机。

应用程序应调用 DeletePrinter 以删除本地打印机。 应用程序应调用 DeletePrinterConnection 以删除与打印机的连接。

要求

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

另请参阅

打印

打印后台处理程序 API 函数

AddPrinterConnection

ClosePrinter

DeletePrinter

DeletePrinterConnection

GetPrinter

PRINTER_INFO_2