IsValidDevmodeW, fonction (winspool.h)
La fonction IsValidDevmode du spouleur d’impression vérifie que le contenu d’une structure DEVMODE est valide.
Syntaxe
BOOL IsValidDevmodeW(
[in, optional] PDEVMODEW pDevmode,
size_t DevmodeSize
);
Paramètres
[in, optional] pDevmode
Pointeur vers la structure DEVMODE à valider.
DevmodeSize
Taille, en octets, de la mémoire tampon pointée par pDevmode.
Valeur de retour
Si la structure DEVMODE est valide ou si la fonction réussit à réparer la structure pour la rendre valide, la fonction retourne TRUE. Sinon, la fonction retourne faux. L’appelant peut obtenir un code d’erreur en appelant GetLastError.
Remarques
Avant d’utiliser une structure DEVMODE obtenue à partir d’une source potentiellement non fiable, un pilote d’imprimante peut appeler cette fonction pour vérifier que la structure est valide. Cette fonction valide uniquement les membres publics de la structure DEVMODE. Elle ne vérifie pas les membres privés de la structure.
Le dmSize membre de la structure DEVMODE spécifie la taille de la structure DEVMODE, sans inclure les données privées spécifiées par le pilote ajoutées à la structure. Le membre dmDriverExtra spécifie la taille des données privées ajoutées à la structure, le cas échéant. Les appelants doivent définir DevModeSize sur dmSize+dmDriverExtra uniquement s’ils peuvent garantir que la taille de la mémoire tampon d’entrée est au moins aussi importante.
Cette fonction ne nécessite pas que l’appelant obtienne des privilèges élevés.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Bureau |
| d’en-tête | winspool.h (inclure Winspool.h) |
| bibliothèque | Winspool.lib |
| DLL | Winspool.drv |