Fonction IsValidDevmodeW (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 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

Voir aussi

DEVMODE