Fonction IsValidDevmodeA (winspool.h)
La fonction IsValidDevmode du spouleur d’impression vérifie que le contenu d’une structure DEVMODE est valide.
Syntaxe
BOOL IsValidDevmodeA(
[in, optional] PDEVMODEA 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 vers pDevmode.
Valeur retournée
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 FALSE. L’appelant peut obtenir un code d’erreur en appelant GetLastError.
Remarques
Avant d’utiliser une structure DEVMODE obtenue à partir d’une source potentiellement peu 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. Il ne case activée pas les membres privés de la structure.
Le membre dmSize 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 grande.
Cette fonction ne nécessite pas que l’appelant obtienne des privilèges élevés.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | winspool.h (inclure Winspool.h) |
Bibliothèque | Winspool.lib |
DLL | Winspool.drv |