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	Winspool.h (incluye Windows.h)
Biblioteca	Winspool.lib
Archivo DLL	Winspool.drv
Nombres Unicode y ANSI	AdvancedDocumentPropertiesW (Unicode) y AdvancedDocumentPropertiesA (ANSI)

Consulte también

Impresión

Funciones de la API del administrador de trabajos de impresión

Addprinter

DEVMODE

Documentproperties

GetPrinter

OpenPrinter

PRINTER_INFO_2