Função IsValidDevmodeW (winspool.h)
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 |