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 |
|---|---|
|
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. |
|
La fonction de boîte de dialogue commune n’a pas pu trouver une ressource spécifiée. |
|
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. |
|
La fonction de boîte de dialogue commune n’a pas pu charger une ressource spécifiée. |
|
La fonction de boîte de dialogue commune n’a pas pu charger une chaîne spécifiée. |
|
La fonction de boîte de dialogue commune n’a pas pu verrouiller une ressource spécifiée. |
|
La fonction de boîte de dialogue commune n’a pas pu allouer de mémoire pour les structures internes. |
|
La fonction de boîte de dialogue commune n’a pas pu verrouiller la mémoire associée à un handle. |
|
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. |
|
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. |
|
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. |
|
La fonction RegisterWindowMessage a renvoyé un code d’erreur lorsqu’elle a été appelée par la fonction de boîte de dialogue commune. |
|
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 |
|---|---|
|
La fonction PrintDlg a échoué lorsqu’elle a tenté de créer un contexte d’informations. |
|
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 . |
|
Les données des structures DEVMODE et DEVNAMES décrivent deux imprimantes différentes. |
|
Le pilote d’imprimante n’a pas pu initialiser une structure DEVMODE . |
|
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. |
|
La fonction PrintDlg n’a pas pu charger le pilote de périphérique pour l’imprimante spécifiée. |
|
Une imprimante par défaut n’existe pas. |
|
Aucun pilote d’imprimante n’a été trouvé. |
|
La fonction PrintDlg n’a pas pu analyser les chaînes dans la section [appareils] du fichier WIN.INI. |
|
La section [appareils] du fichier WIN.INI ne contenait pas d’entrée pour l’imprimante demandée. |
|
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. |
|
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 |
|---|---|
|
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 . |
|
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 |
|---|---|
|
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. |
|
Un nom de fichier n’est pas valide. |
|
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 |
|---|---|
|
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
Bibliothèque de boîtes de dialogue commune
Conceptuel
Référence