Partager via


CommDlgExtendedError, fonction (commdlg.h)

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)

Voir aussi

CHOOSECOLOR

CHOOSEFONT

ChooseColor

ChooseFont

Bibliothèque de boîtes de dialogue commune

Conceptuel

DEVNAMES

DialogBox

FINDREPLACE

FindText

GetOpenFileName

GetSaveFileName

OPENFILENAME

PAGESETUPDLG

PRINTDLG

PageSetupDlg

PrintDlg

Référence

RegisterWindowMessage

ReplaceText