CommDlgExtendedError, fonction (commdlg.h)

Article
02/24/2024

Retourne un code d’erreur de boîte de dialogue courant. Ce code indique l’erreur la plus récente à produire pendant l’exécution de l’une des fonctions de boîte de dialogue courantes.

Syntaxe

DWORD CommDlgExtendedError();

Valeur de retour

Type : DWORD

Si l’appel le plus récent à une fonction de boîte de dialogue commune a réussi, la valeur de retour n’est pas définie. Si la fonction de boîte de dialogue commune a retourné FALSE parce que l’utilisateur a fermé ou annulé la boîte de dialogue, la valeur de retour est zéro. Sinon, la valeur de retour est un code d’erreur différent de zéro.

La fonction CommDlgExtendedError peut retourner des codes d’erreur généraux pour toutes les fonctions de boîte de dialogue courantes. En outre, il existe des codes d’erreur qui sont retournés uniquement pour une boîte de dialogue commune spécifique. Tous ces codes d’erreur sont définis dans Cderr.h. Les codes d’erreur généraux suivants peuvent être retournés pour toutes les fonctions de boîte de dialogue courantes.

Code/valeur de retour	Description
CDERR_DIALOGFAILURE 0xFFFF	Impossible de créer la boîte de dialogue. L’appel de la fonction de boîte de dialogue commune à la fonction DialogBox a échoué. Par exemple, cette erreur se produit si l’appel de boîte de dialogue courant spécifie un handle de fenêtre non valide.
CDERR_FINDRESFAILURE 0x0006	La fonction de boîte de dialogue commune n’a pas pu trouver une ressource spécifiée.
CDERR_INITIALIZATION 0x0002	La fonction de boîte de dialogue commune a échoué pendant l’initialisation. Cette erreur se produit souvent lorsque la mémoire n’est pas suffisante.
CDERR_LOADRESFAILURE 0x0007	La fonction de boîte de dialogue commune n’a pas pu charger une ressource spécifiée.
CDERR_LOADSTRFAILURE 0x0005	La fonction de boîte de dialogue commune n’a pas pu charger une chaîne spécifiée.
CDERR_LOCKRESFAILURE 0x0008	La fonction de boîte de dialogue commune n’a pas pu verrouiller une ressource spécifiée.
CDERR_MEMALLOCFAILURE 0x0009	La fonction de boîte de dialogue commune n’a pas pu allouer de mémoire pour les structures internes.
CDERR_MEMLOCKFAILURE 0x000A	La fonction de boîte de dialogue commune n’a pas pu verrouiller la mémoire associée à un handle.
CDERR_NOHINSTANCE 0x0004	L’indicateur ENABLETEMPLATE a été défini dans le membre Indicateurs de la structure d’initialisation de la boîte de dialogue commune correspondante, mais vous n’avez pas pu fournir un instance handle correspondant.
CDERR_NOHOOK 0x000B	L’indicateur ENABLEHOOK a été défini dans le membre Indicateurs de la structure d’initialisation de la boîte de dialogue commune correspondante, mais vous n’avez pas pu fournir de pointeur vers une procédure de hook correspondante.
CDERR_NOTEMPLATE 0x0003	L’indicateur ENABLETEMPLATE a été défini dans le membre Indicateurs de la structure d’initialisation de la boîte de dialogue commune correspondante, mais vous n’avez pas pu fournir de modèle correspondant.
CDERR_REGISTERMSGFAIL 0x000C	La fonction RegisterWindowMessage a renvoyé un code d’erreur lorsqu’elle a été appelée par la fonction de boîte de dialogue commune.
CDERR_STRUCTSIZE 0x0001	Le membre lStructSize de la structure d’initialisation de la boîte de dialogue commune correspondante n’est pas valide.

Les codes d’erreur suivants peuvent être retournés pour la fonction PrintDlg .

Code/valeur de retour	Description
PDERR_CREATEICFAILURE 0x100A	La fonction PrintDlg a échoué lorsqu’elle a tenté de créer un contexte d’informations.
PDERR_DEFAULTDIFFERENT 0x100C	Vous avez appelé la fonction PrintDlg avec l’indicateur DN_DEFAULTPRN spécifié dans le membre wDefault de la structure DEVNAMES , mais l’imprimante décrite par les autres membres de la structure ne correspondait pas à l’imprimante par défaut actuelle. Cette erreur se produit lorsque vous stockez la structure DEVNAMES et que l’utilisateur modifie l’imprimante par défaut à l’aide du Panneau de configuration. Pour utiliser l’imprimante décrite par la structure DEVNAMES , effacez l’indicateur DN_DEFAULTPRN et appelez à nouveau PrintDlg . Pour utiliser l’imprimante par défaut, remplacez la structure DEVNAMES (et la structure, le cas échéant) par NULL ; et appelez à nouveau PrintDlg .
PDERR_DNDMMISMATCH 0x1009	Les données des structures DEVMODE et DEVNAMES décrivent deux imprimantes différentes.
PDERR_GETDEVMODEFAIL 0x1005	Le pilote d’imprimante n’a pas pu initialiser une structure DEVMODE .
PDERR_INITFAILURE 0x1006	La fonction PrintDlg a échoué pendant l’initialisation, et il n’existe aucun code d’erreur étendu plus spécifique pour décrire l’échec. Il s’agit du code d’erreur par défaut générique pour la fonction.
PDERR_LOADDRVFAILURE 0x1004	La fonction PrintDlg n’a pas pu charger le pilote de périphérique pour l’imprimante spécifiée.
PDERR_NODEFAULTPRN 0x1008	Une imprimante par défaut n’existe pas.
PDERR_NODEVICES 0x1007	Aucun pilote d’imprimante n’a été trouvé.
PDERR_PARSEFAILURE 0x1002	La fonction PrintDlg n’a pas pu analyser les chaînes dans la section [appareils] du fichier WIN.INI.
PDERR_PRINTERNOTFOUND 0x100B	La section [appareils] du fichier WIN.INI ne contenait pas d’entrée pour l’imprimante demandée.
PDERR_RETDEFFAILURE 0x1003	L’indicateur PD_RETURNDEFAULT a été spécifié dans le membre Flags de la structure PRINTDLG , mais le membre hDevMode ou hDevNames n’était pas NULL.
PDERR_SETUPFAILURE 0x1001	La fonction PrintDlg n’a pas pu charger les ressources requises.

Les codes d’erreur suivants peuvent être retournés pour la fonction ChooseFont .

Code/valeur de retour	Description
CFERR_MAXLESSTHANMIN 0x2002	La taille spécifiée dans le membre nSizeMax de la structure CHOOSEFONT est inférieure à la taille spécifiée dans le membre nSizeMin .
CFERR_NOFONTS 0x2001	Il n’existe aucune police.

Les codes d’erreur suivants peuvent être retournés pour les fonctions GetOpenFileName et GetSaveFileName .

Code/valeur de retour	Description
FNERR_BUFFERTOOSMALL 0x3003	La mémoire tampon vers laquelle pointe le membre lpstrFile de la structure OPENFILENAME est trop petite pour le nom de fichier spécifié par l’utilisateur. Les deux premiers octets de la mémoire tampon lpstrFile contiennent une valeur entière spécifiant la taille requise pour recevoir le nom complet, en caractères.
FNERR_INVALIDFILENAME 0x3002	Un nom de fichier n’est pas valide.
FNERR_SUBCLASSFAILURE 0x3001	Une tentative de sous-classe d’une zone de liste a échoué, car la mémoire n’était pas suffisante.

Le code d’erreur suivant peut être retourné pour les fonctions FindText et ReplaceText .

Code/valeur de retour	Description
FRERR_BUFFERLENGTHZERO 0x4001	Un membre de la structure FINDREPLACE pointe vers une mémoire tampon non valide.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	commdlg.h (inclure Windows.h)
Bibliothèque	Comdlg32.lib
DLL	Comdlg32.dll
Ensemble d’API	ext-ms-win-shell-comdlg32-l1-1-0 (introduit dans Windows 10, version 10.0.10240)