Função IsValidDevmodeW (winspool.h)

  • Artigo

A função IsValidDevmode do spooler de impressão verifica se o conteúdo de uma estrutura DEVMODE é válido.

Sintaxe

BOOL IsValidDevmodeW(
  [in, optional] PDEVMODEW pDevmode,
                 size_t    DevmodeSize
);

Parâmetros

[in, optional] pDevmode

Ponteiro para a estrutura DEVMODE a ser validada.

DevmodeSize

Tamanho, em bytes, do buffer apontado por pDevmode.

Retornar valor

Se a estrutura DEVMODE for válida ou se a função tiver êxito em reparar a estrutura para torná-la válida, a função retornará TRUE. Caso contrário, a função retornará FALSE. O chamador pode obter um código de erro chamando GetLastError.

Comentários

Antes de usar uma estrutura DEVMODE obtida de uma fonte possivelmente não confiável, um driver de impressora pode chamar essa função para verificar se a estrutura é válida. Essa função valida apenas os membros públicos da estrutura DEVMODE. Ele não marcar os membros privados da estrutura.

O membro dmSize da estrutura DEVMODE especifica o tamanho da estrutura DEVMODE, sem incluir dados privados especificados pelo driver anexados à estrutura. O membro dmDriverExtra especifica o tamanho dos dados privados acrescentados à estrutura, se houver algum. Os chamadores devem definir DevModeSize como dmSize+dmDriverExtra somente se puderem garantir que o tamanho do buffer de entrada seja pelo menos tão grande.

Essa função não exige que o chamador obtenha privilégios elevados.

Requisitos

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

Confira também

DEVMODE