ConnectToPrinterDlg
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