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, auf den pDevmode verweist, in Bytes.
Rückgabewert
Wenn die DEVMODE-Struktur gültig ist oder die Funktion die Struktur erfolgreich repariert, um sie gültig zu machen, gibt die Funktion TRUE zurück. Andernfalls gibt die Funktion FALSE zurück. Der Aufrufer kann einen Fehlercode abrufen, indem er GetLastError aufruft.
Hinweise
Vor der Verwendung einer DEVMODE-Struktur, die von einer möglicherweise unzuverlässigen Quelle abgerufen wurde, 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 Elemente der Struktur werden nicht überprüft.
Das dmSize-Element der DEVMODE-Struktur gibt die Größe der DEVMODE-Struktur an, einschließlich privater, treiberspezifischer Daten, die an die Struktur angefügt werden. Das dmDriverExtra-Element gibt die Größe der privaten Daten an, die an die Struktur angefügt werden, sofern vorhanden. Aufrufer sollten DevModeSize nur dann auf dmSize+dmDriverExtra festlegen, wenn sie garantieren können, dass die Größe des Eingabepuffers mindestens so groß ist.
Für diese Funktion muss der Aufrufer keine erhöhten Berechtigungen erhalten.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Desktop |
| Kopfzeile | winspool.h (einschließlich Winspool.h) |
| Bibliothek | Winspool.lib |
| DLL | Winspool.drv |