Función AdvancedDocumentProperties
La función AdvancedDocumentProperties muestra un cuadro de diálogo de configuración de impresora para la impresora especificada, lo que permite al usuario configurar esa impresora.
Esta función es un caso especial de la función DocumentProperties . Para obtener más información, consulte la sección Comentarios.
Sintaxis
LONG AdvancedDocumentProperties(
_In_ HWND hWnd,
_In_ HANDLE hPrinter,
_In_ LPTSTR pDeviceName,
_Out_ PDEVMODE pDevModeOutput,
_In_ PDEVMODE pDevModeInput
);
Parámetros
-
hWnd [in]
-
Identificador de la ventana primaria del cuadro de diálogo de configuración de impresora.
-
hPrinter [in]
-
Identificador de un objeto de impresora. Use la función OpenPrinter o AddPrinter para recuperar un identificador de impresora.
-
pDeviceName [in]
-
Puntero a una cadena terminada en null que especifica el nombre del dispositivo para el que se debe mostrar un cuadro de diálogo de configuración de impresora.
-
pDevModeOutput [out]
-
Puntero a una estructura DEVMODE que contendrá los datos de configuración especificados por el usuario.
-
pDevModeInput [in]
-
Puntero a una estructura DEVMODE que contiene los datos de configuración utilizados para inicializar los controles del cuadro de diálogo de configuración de impresora.
Valor devuelto
Si la función DocumentProperties con estos parámetros es correcta, el valor devuelto de AdvancedDocumentProperties es 1. De lo contrario, el valor devuelto es cero.
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.
Esta función solo puede mostrar el cuadro de diálogo de configuración de impresora para que un usuario pueda configurarla. Para obtener más control, use DocumentProperties. Los parámetros de entrada de esta función se pasan directamente a DocumentProperties y el valor fMode se establece en DM_IN_BUFFER | DM_IN_PROMPT | DM_OUT_BUFFER. A diferencia de DocumentProperties, esta función solo devuelve 1 o 0. Por lo tanto, no se puede determinar el tamaño necesario de DEVMODE estableciendo pDevMode en cero.
Una aplicación puede obtener el nombre al que apunta el parámetro pDeviceName llamando a la función GetPrinter y examinando después el miembro pPrinterName de la estructura PRINTER_INFO_2 .
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 |
|
| Nombres Unicode y ANSI |
AdvancedDocumentPropertiesW (Unicode) y AdvancedDocumentPropertiesA (ANSI) |