平台 SDK: Windows GDI

ConnectToPrinterDlg

ConnectToPrinterDlg函数显示一个对话框,让用户浏览并连接到网络上的打印机。 如果用户选择打印机,该功能会尝试创建与其的连接; 如果服务器上没有安装合适的驱动程序,用户可以选择在本地创建打印机。

HANDLE ConnectToPrinterDlg(
  HWND hwnd,    // handle to parent window  
  DWORD Flags   // reserved; must be zero
);

参数

  • hwnd

  • [in] 指定对话框的父窗口。

  • Flags

  • [in] 该参数被保留并且必须为零。

返回值

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

如果该函数失败,或者用户在不选择打印机的情况下取消对话框,则返回值为NULL。

备注

ConnectToPrinterDlg函数尝试创建到选定打印机的连接。 但是,如果打印机所在的服务器没有安装合适的驱动程序,该功能可让用户选择在本地创建打印机。 调用应用程序可以通过调用具有PRINTER_INFO_2结构的GetPrinter来确定该函数是否在本地创建了打印机,然后检查该结构的Attributes成员。

应用程序应该调用DeletePrinter来删除本地打印机。 应用程序应该调用DeletePrinterConnection删除到打印机的连接。

要求

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

  Windows 95/98/Me: 不支持。

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