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

El IPrintOemUI::DevQueryPrintEx método 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 OEMUIOBJ .

pDQPInfo

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

pPublicDM

Puntero proporcionado por el autor de la llamada a una estructura 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 está implementado.

Comentarios

Un método del complemento de interfaz de IPrintOemUI::DevQueryPrintEx usuario realiza los mismos tipos de operaciones que la función 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 DevQueryPrintEx , la IPrintOemUI::DevQueryPrintEx responsabilidad del método es determinar si se puede imprimir el trabajo de impresión descrito por la estructura DEVMODEW proporcionada.

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

Si IPrintOemUI::DevQueryPrintEx varios complementos de interfaz de usuario exportan 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 Personalizar los controladores de impresora de Microsoft.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	prcomoem.h (incluya Prcomoem.h)

Consulte también

DevQueryPrintEx