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

Artigo
02/07/2025

O método IPrintOemUI::DevQueryPrintEx permite que um plug-in de interface do usuário ajude a determinar se um trabalho de impressão é imprimível.

Sintaxe

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

Parâmetros

poemuiobj

Ponteiro fornecido pelo chamador para uma estrutura de OEMUIOBJ.

pDQPInfo

Ponteiro fornecido pelo chamador para uma estrutura de DEVQUERYPRINT_INFO.

pPublicDM

Ponteiro fornecido pelo chamador para uma estrutura de DEVMODEW validada.

pOEMDM

Ponteiro fornecido pelo chamador para os membros da estrutura DEVMODEW privada do plug-in de interface do usuário.

Valor de retorno

O método deve retornar um dos valores a seguir.

Código de retorno	Descrição
S_OK	A operação foi bem-sucedida.
E_FAIL	Falha na operação.
E_NOTIMPL	O método não é implementado.

Observações

O método IPrintOemUI::DevQueryPrintEx de um plug-in de interface do usuário executa os mesmos tipos de operações que a função DevQueryPrintEx exportada por DLLs da interface da impressora no modo de usuário. Você pode usar esse método para aprimorar a funcionalidade fornecida pela função de DevQueryPrintEx. Assim como a função DevQueryPrintEx, a responsabilidade do método IPrintOemUI::DevQueryPrintEx é determinar se o trabalho de impressão descrito pela estrutura DEVMODEW fornecida pode ser impresso.

Quando a função DevQueryPrintEx do driver é chamada, ela verifica a estrutura DEVMODEW, juntamente com as opções de impressora selecionadas no momento, para determinar se o trabalho é imprimível. Se não estiver, a função retornará false. Se o trabalho parecer imprimível, a função chamará o método IPrintOemUI::DevQueryPrintEx em cada plug-in de interface do usuário associado ao driver. Se todos os métodos IPrintOemUI::DevQueryPrintEx retornarem S_OK, DevQueryPrintEx retornará verdadeiro. Portanto, um trabalho não é imprimível, a menos que a função DevQueryPrintEx e todos os métodos IPrintOemUI::DevQueryPrintEx declarem-na imprimível.

Se IPrintOemUI::DevQueryPrintEx métodos forem exportados por vários plug-ins de interface do usuário, os métodos serão chamados na ordem em que os plug-ins são especificados para instalação.

Para obter mais informações sobre como criar e instalar plug-ins de interface do usuário, consulte Personalizando os drivers de impressora da Microsoft.

Requisitos

Requisito	Valor
da Plataforma de Destino	Área de trabalho
cabeçalho	prcomoem.h (inclua Prcomoem.h)

Consulte também

DevQueryPrintEx

Compartilhar via