Método IPrintOemUI::D evQueryPrintEx (prcomoem.h)

El método IPrintOemUI::DevQueryPrintEx permite que un complemento de interfaz de usuario ayude a determinar si se puede imprimir un trabajo de impresión.

Sintaxis

HRESULT DevQueryPrintEx(
  POEMUIOBJ           poemuiobj,
  PDEVQUERYPRINT_INFO pDQPInfo,
  PDEVMODE            pPublicDM,
  PVOID               pOEMDM
);

Parámetros

poemuiobj

Puntero proporcionado por el autor de la llamada a una estructura de OEMUIOBJ de.

pDQPInfo

Puntero proporcionado por el autor de la llamada a una estructura de DEVQUERYPRINT_INFO.

pPublicDM

Puntero proporcionado por el autor de la llamada a una estructura de DEVMODEW validada.

pOEMDM

Puntero proporcionado por el autor de la llamada a los miembros privados de la estructura DEVMODEW del complemento de interfaz de usuario.

Valor devuelto

El método debe devolver uno de los valores siguientes.

Código devuelto	Descripción
S_OK	La operación se realizó correctamente.
E_FAIL	Error en la operación.
E_NOTIMPL	El método no se implementa.

Observaciones

El método IPrintOemUI::DevQueryPrintEx de un complemento de interfaz de usuario realiza los mismos tipos de operaciones que la función de DevQueryPrintEx que exporta los archivos DLL de la interfaz de impresora en modo de usuario. Puede usar este método para mejorar la funcionalidad proporcionada por la función DevQueryPrintEx. Al igual que la función de DevQueryPrintEx, la responsabilidad del método IPrintOemUI::DevQueryPrintEx es determinar si se puede imprimir el trabajo de impresión descrito por la estructura DEVMODEW proporcionada.

Cuando se llama a la función de controlador DevQueryPrintEx, comprueba la estructura DEVMODEW, junto con las opciones de impresora actualmente seleccionadas, para determinar si el trabajo es imprimible. Si no es así, la función devuelve FALSE. Si el trabajo parece ser imprimible, la función llama al método IPrintOemUI::DevQueryPrintEx en cada complemento de interfaz de usuario asociado al controlador. Si todos los métodos de IPrintOemUI::DevQueryPrintEx devuelven S_OK, DevQueryPrintEx devuelve TRUE. Por lo tanto, un trabajo no se puede imprimir a menos que la función de DevQueryPrintEx y todos los métodos IPrintOemUI::DevQueryPrintEx lo declaren imprimible.

Si varios complementos de interfaz de usuario exportan IPrintOemUI::DevQueryPrintEx métodos, se llama a los métodos en el orden en que se especifican los complementos para la instalación.

Para obtener más información sobre cómo crear e instalar complementos de interfaz de usuario, vea Personalización de los controladores de impresora de Microsoft.

Requisitos

Requisito	Valor
de la plataforma de destino de	Escritorio
encabezado de	prcomoem.h (include Prcomoem.h)

Consulte también

DevQueryPrintEx