Partilhar via

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

  • Artigo

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

pDQPInfo

Ponteiro fornecido pelo chamador para uma estrutura DEVQUERYPRINT_INFO .

pPublicDM

Ponteiro fornecido pelo chamador para uma estrutura DEVMODEW validada.

pOEMDM

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

Retornar valor

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

Código de retorno Descrição
S_OK
 A operação foi realizada com êxito.
E_FAIL
 Falha na operação.
E_NOTIMPL
 O método não está implementado.

Comentários

O método de um plug-in de interface do IPrintOemUI::DevQueryPrintEx usuário executa os mesmos tipos de operações que a função DevQueryPrintEx exportada por DLLs da interface da impressora do modo de usuário. Você pode usar esse método para aprimorar a funcionalidade fornecida pela função DevQueryPrintEx . Assim como a função DevQueryPrintEx , a IPrintOemUI::DevQueryPrintEx responsabilidade do método é 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 for, a função retornará FALSE. Se o trabalho parecer imprimível, a função chamará o IPrintOemUI::DevQueryPrintEx método em cada plug-in de interface do usuário associado ao driver. Se todos os IPrintOemUI::DevQueryPrintEx métodos retornarem S_OK, DevQueryPrintEx retornará TRUE. Portanto, um trabalho não é imprimível, a menos que a função DevQueryPrintEx e todos os IPrintOemUI::DevQueryPrintEx métodos o declarem imprimível.

Se IPrintOemUI::DevQueryPrintEx os 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 drivers de impressora da Microsoft.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho prcomoem.h (inclua Prcomoem.h)

Confira também

DevQueryPrintEx