IsValidDevmodeW-Funktion (winspool.h)

  • Artikel

Die IsValidDevmode-Funktion des Druckspoolers überprüft, ob der Inhalt einer DEVMODE-Struktur gültig ist.

Syntax

BOOL IsValidDevmodeW(
  [in, optional] PDEVMODEW 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

Weitere Informationen

DEVMODE