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 .

Retornar valor

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 estiver marcada na página Avançado da folha de propriedades da impressora. Se a função retornar TRUE, o spooler enfileira o trabalho de impressão para impressão. Caso contrário, o trabalho será mantido, 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 da impressora atual.

Se o trabalho puder ser impresso, a função deverá retornar APENAS 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 exibivel (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 que podem ser exibidas devem ser definidas como recursos de cadeia de caracteres em um arquivo de recurso.

Requisitos

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