IsValidDevmodeA-Funktion (winspool.h)
Die IsValidDevmode-Funktion des Druckspoolers überprüft, ob der Inhalt einer DEVMODE- Struktur gültig ist.
Syntax
BOOL IsValidDevmodeA(
[in, optional] PDEVMODEA pDevmode,
size_t DevmodeSize
);
Parameter
[in, optional] pDevmode
Zeiger auf die zu überprüfende DEVMODE-Struktur.
DevmodeSize
Größe des Puffers in Bytes, auf den pDevmodeverweist.
Rückgabewert
Wenn die DEVMODE-Struktur gültig ist oder die Funktion erfolgreich die Struktur repariert, um sie gültig zu machen, gibt die Funktion TRUEzurück. Andernfalls gibt die Funktion FALSEzurück. Der Aufrufer kann einen Fehlercode abrufen, indem GetLastErroraufgerufen wird.
Bemerkungen
Bevor Sie eine DEVMODE-Struktur verwenden, die von einer möglicherweise unzuverlässigen Quelle abgerufen wird, kann ein Druckertreiber diese Funktion aufrufen, um zu überprüfen, ob die Struktur gültig ist. Diese Funktion überprüft nur die öffentlichen Member der DEVMODE-Struktur. Die privaten Mitglieder der Struktur werden nicht überprüft.
Das dmSize Member der DEVMODE-Struktur gibt die Größe der DEVMODE-Struktur an, einschließlich privater, treiberspezifischer Daten, die an die Struktur angefügt wurden. Der dmDriverExtra Member gibt die Größe der privaten Daten an, die an die Struktur angefügt werden, sofern vorhanden. Anrufer sollten DevModeSize- auf dmSize+dmDriverExtra- festlegen, wenn sie sicherstellen können, dass die Größe des Eingabepuffers mindestens so groß ist.
Diese Funktion erfordert nicht, dass der Aufrufer erhöhte Rechte erhält.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Desktop |
| Header- | winspool.h (include Winspool.h) |
| Library | Winspool.lib |
| DLL- | Winspool.drv |