Función ConnectToPrinterDlg
La función ConnectToPrinterDlg muestra un cuadro de diálogo que permite a los usuarios examinar y conectarse a impresoras en una red. Si el usuario selecciona una impresora, la función intenta crear una conexión a ella; Si un controlador adecuado no está instalado en el servidor, el usuario tiene la opción de crear una impresora localmente.
Sintaxis
HANDLE ConnectToPrinterDlg(
_In_ HWND hwnd,
_In_ DWORD Flags
);
Parámetros
-
hwnd [in]
-
Especifica la ventana primaria del cuadro de diálogo.
-
Marcas [in]
-
Este parámetro está reservado y debe ser cero.
Valor devuelto
Si la función se ejecuta correctamente y el usuario selecciona una impresora, el valor devuelto es un identificador para la impresora seleccionada.
Si se produce un error en la función o el usuario cancela el cuadro de diálogo sin seleccionar una impresora, el valor devuelto es NULL.
Comentarios
Nota:
Se trata de una función de bloqueo o sincrónica que podría no devolverse inmediatamente. La rapidez con la que devuelve esta función depende de factores en tiempo de ejecución, como el estado de red, la configuración del servidor de impresión y los factores de implementación del controlador de impresora que son difíciles de predecir al escribir una aplicación. Llamar a esta función desde un subproceso que administra la interacción con la interfaz de usuario podría hacer que la aplicación parezca que no responde.
La función ConnectToPrinterDlg intenta crear una conexión a la impresora seleccionada. Sin embargo, si el servidor en el que reside la impresora no tiene instalado un controlador adecuado, la función ofrece al usuario la opción de crear una impresora localmente. Una aplicación que realiza una llamada puede determinar si la función ha creado una impresora localmente llamando a GetPrinter con una estructura de PRINTER_INFO_2 y, a continuación, examinando el miembro Attributes de esa estructura.
Una aplicación debe llamar a DeletePrinter para eliminar una impresora local. Una aplicación debe llamar a DeletePrinterConnection para eliminar una conexión a una impresora.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows 2000 Server [solo aplicaciones de escritorio] |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|