Share via


Função IsValidDevmode

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

Sintaxe

BOOL IsValidDevmode(
  _In_ PDEVMODE pDevmode,
       size_t   DevmodeSize
);

Parâmetros

pDevmode [in]

Um ponteiro para o DEVMODE a ser validado.

DevmodeSize

O tamanho em bytes do buffer de bytes de entrada.

Valor retornado

TRUE, se o DEVMODE for estruturalmente válido. Se forem encontrados erros secundários, a função os corrigirá e retornará TRUE.

FALSE, se o DEVMODE tiver um ou mais problemas estruturais significativos. Por exemplo, seu membro dmSize é desalinhado ou especifica um buffer muito pequeno. Além disso, FALSE se pDevmode for NULL.

Comentários

Nenhum campo de driver de impressora privada do DEVMODE é verificado, somente os campos públicos.

Os chamadores devem usar dmSize+dmDriverExtra para DevmodeSize somente se puderem garantir que o tamanho do buffer de entrada seja pelo menos tão grande. Como o DEVMODE geralmente não é confiável, os valores que estão no buffer de entrada nos deslocamentos dmSize e dmDriverExtra também não são confiáveis.

Essa função é executável no contexto da conta de usuário Least-Privileged (LUA).

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho
Winspool.h
Biblioteca
Winspool.lib
DLL
Winspool.drv
Nomes Unicode e ANSI
IsValidDevmodeW (Unicode) e IsValidDevmodeA (ANSI)

Confira também

Impressão

Funções da API do Spooler de impressão

DEVMODE