The ConnectToPrinterDlg function displays a dialog box that lets users browse and connect to printers on a network. If the user selects a printer, the function attempts to create a connection to it; if a suitable driver is not installed on the server, the user is given the option of creating a printer locally.
HANDLE ConnectToPrinterDlg (
|
HWND hwnd, |
// handle to parent window of dialog box |
|
DWORD Flags |
// reserved for future use, must be zero |
|
); |
If the function succeeds and the user selects a printer, the return value is a handle to the selected printer.
If the function fails, or the user cancels the dialog box without selecting a printer, the return value is NULL.
The ConnectToPrinterDlg function attempts to create a connection to the selected printer. However, if the server on which the printer resides does not have a suitable driver installed, the function offers the user the option of creating a printer locally. A calling application can determine whether the function has created a printer locally by calling GetPrinter with a PRINTER_INFO_2 structure, then examining that structure’s Attributes member.
An application should call DeletePrinter to delete a local printer. An application should call DeletePrinterConnection to delete a connection to a printer.
AddPrinterConnection, ClosePrinter, DeletePrinter, DeletePrinterConnection, GetPrinter, PRINTER_INFO_2