Funzione IsValidDevmodeW (winspool.h)

La funzione IsValidDevmode dello spooler di stampa verifica che il contenuto di una struttura DEVMODE sia valido.

Sintassi

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

Parametri

[in, optional] pDevmode

Puntatore alla struttura DEVMODE da convalidare.

DevmodeSize

Dimensioni, in byte, del buffer a cui punta pDevmode.

Valore restituito

Se la struttura DEVMODE è valida o se la funzione riesce a ripristinare la struttura per renderla valida, la funzione restituisce TRUE. In caso contrario, la funzione restituisce FALSE. Il chiamante può ottenere un codice di errore chiamando GetLastError.

Commenti

Prima di usare una struttura DEVMODE ottenuta da un'origine possibilmente inaffidabile, un driver della stampante può chiamare questa funzione per verificare che la struttura sia valida. Questa funzione convalida solo i membri pubblici della struttura DEVMODE. Non controlla i membri privati della struttura.

Il membro dmSize della struttura DEVMODE specifica le dimensioni della struttura DEVMODE, senza includere dati privati specificati dal driver aggiunti alla struttura. Il membro dmDriverExtra specifica le dimensioni dei dati privati aggiunti alla struttura, se presenti. I chiamanti devono impostare DevModeSize su dmSize+dmDriverExtra solo se possono garantire che le dimensioni del buffer di input siano almeno di grandi dimensioni.

Questa funzione non richiede al chiamante di ottenere privilegi elevati.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	winspool.h (include Winspool.h)
Libreria	Winspool.lib
DLL	Winspool.drv

Vedi anche

DEVMODE