Função IsValidDevmodeA (winspool.h)
A função IsValidDevmode do spooler de impressão verifica se o conteúdo de uma estrutura de DEVMODE é válido.
Sintaxe
BOOL IsValidDevmodeA(
[in, optional] PDEVMODEA 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.
Valor de retorno
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á VERDADEIRO. Caso contrário, a função retornará FALSE. O chamador pode obter um código de erro chamando GetLastError.
Observações
Antes de usar uma estrutura DEVMODE obtida de uma origem 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 verifica os membros privados da estrutura.
O dmSize membro da estrutura DEVMODE especifica o tamanho da estrutura DEVMODE, não incluindo dados privados especificados pelo driver anexados à estrutura. O membro dmDriverExtra especifica o tamanho dos dados privados anexados à estrutura, se houver algum. Os chamadores devem definir devModeSize para 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 |
|---|---|
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | winspool.h (inclua Winspool.h) |
| biblioteca | Winspool.lib |
| de DLL | Winspool.drv |