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 |
| ); |
Parameters
hwnd
Specifies the parent window of the dialog box.
Flags
This parameter is reserved for future use. Set it to zero.
Return Values
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.
Remarks
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.
See Also
AddPrinterConnection, ClosePrinter, DeletePrinter, DeletePrinterConnection, GetPrinter, PRINTER_INFO_2