Função DevQueryPrintEx (winddiui.h)

A função DevQueryPrintEx de uma interface de impressora determina se um trabalho de impressão especificado é compatível com a configuração atual da impressora e, portanto, pode ser impresso.

Sintaxe

BOOL DevQueryPrintEx(
  [in, out] PDEVQUERYPRINT_INFO pDQPInfo
);

Parâmetros

[in, out] pDQPInfo

Ponteiro fornecido pelo chamador para uma estrutura DEVQUERYPRINT_INFO .

Valor retornado

Se o trabalho de impressão puder ser impresso, a função deverá retornar TRUE; caso contrário, ele deve retornar FALSE.

Comentários

As DLLs da interface da impressora devem definir uma função DevQueryPrintEx . A função será chamada pelo spooler de impressão se a opção Manter Documentos Incompatíveis for verificada na página Avançado da folha de propriedades da impressora. Se a função retornar TRUE, o spooler enfia o trabalho de impressão para impressão. Caso contrário, o trabalho será realizado, sob a suposição de que a impressora eventualmente será reconfigurada para que o trabalho possa ser impresso.

A estrutura de DEVQUERYPRINT_INFO recebida aponta para uma estrutura DEVMODEW que descreve as características da impressora exigidas pelo trabalho de impressão. A função DevQueryPrintEx deve primeiro verificar se os membros de tamanho e versão da estrutura DEVMODEW recebida são compatíveis com o driver. Em seguida, ele deve determinar se o conteúdo DEVMODEW fornecido é compatível com a configuração atual da impressora.

Se o trabalho puder ser impresso, a função deverá retornar TRUE. Se o trabalho deve ser mantido até mais tarde, a função deverá retornar FALSE depois de fornecer uma cadeia de caracteres de texto exibiível (no buffer apontado pelo membro pszErrorStr da estrutura DEVQUERYPRINT_INFO) descrevendo o motivo pelo qual o trabalho não pode ser impresso.

Cadeias de caracteres de texto exibiíveis devem ser definidas como recursos de cadeia de caracteres em um arquivo de recurso.

Requisitos

   
Plataforma de Destino Área de Trabalho
Cabeçalho winddiui.h (inclua Winddiui.h)
Biblioteca Winspool.lib
DLL WinSpool.drv