Die CommDlgExtendedError -Funktion gibt einen gemeinsamen Dialog Feld Fehlercode. Dieser Code gibt den letzten Fehler während der Ausführung eines der folgenden allgemeinen Dialogfeld Feld Funktionen:
| ChooseColor | GetOpenFileName |
| ChooseFont | GetSaveFileName |
| Suchtext | PrintDlg |
| ReplaceText | PageSetupDlg |
DWORD CommDlgExtendedError(VOID)
Diese Funktion hat keine Parameter.
Wenn der jüngste Aufruf eine gemeinsame Dialogfeld Feld Funktion erfolgreich ausgeführt wurde, ist der Rückgabewert nicht definiert.
Wenn die Standarddialogfunktion Feld FALSE zurückgegeben, da der Benutzer geschlossen oder das Dialogfeld abgebrochen, ist der Rückgabewert 0 (null). Andernfalls ist der Rückgabewert ein Fehlercode ungleich NULL. Weitere Informationen finden Sie unter den folgenden Abschnitt "Hinweise".
Die CommDlgExtendedError -Funktion kann allgemeine Fehlercodes für die allgemeine Dialogfeld Feld Funktionen zurück. Darüber hinaus gibt es Fehlercodes, die nur für einen bestimmten Standarddialogfelds zurückgegeben werden. Die von CommDlgExtendedError zurückgegebenen Fehlercodes sind in der CDERR definiert.H-Datei.
Die folgenden allgemeinen Fehlercodes können für die gemeinsame Dialogfeld Feld Funktionen zurückgegeben werden:
| Wert | Bedeutung |
|---|---|
| CDERR_DIALOGFAILURE | Das Dialogfeld konnte nicht erstellt werden. Die allgemeine Dialogfeld Feld Funktion Aufruf der DialogBox -Funktion ist fehlgeschlagen. Beispielsweise tritt dieser Fehler wenn der gemeinsame Dialog Feld Aufruf ein ungültiges Fensterhandle gibt. |
| CDERR_FINDRESFAILURE | Feld die Standarddialogfunktion konnte eine angegebene Ressource gefunden. |
| CDERR_INITIALIZATION | Die Standarddialogfunktion Feld ist während der Initialisierung fehlgeschlagen. Dieser Fehler tritt häufig bei nicht genügend Arbeitsspeicher verfügbar ist. |
| CDERR_LOADRESFAILURE | Feld die Standarddialogfunktion konnte eine angegebene Ressource laden. |
| CDERR_LOADSTRFAILURE | Die Standarddialogfunktion Feld eine angegebene Zeichenfolge konnte nicht geladen. |
| CDERR_LOCKRESFAILURE | Feld die Standarddialogfunktion konnte eine angegebene Ressource sperren. |
| CDERR_MEMALLOCFAILURE | Die Standarddialogfunktion Feld war konnte keinen Speicher für interne Strukturen reservieren. |
| CDERR_MEMLOCKFAILURE | Feld die Standarddialogfunktion konnte ein Handle zugeordneten Arbeitsspeicher Sperren. |
| CDERR_NOHINSTANCE | Das Attribut ENABLETEMPLATE wurde in den Flaggen der Initialisierung Struktur für die entsprechenden Standarddialogfeld, Sie konnte jedoch eine entsprechende Instanzzugriffsnummer bereitstellen. |
| CDERR_NOHOOK | Die ENABLEHOOK Flag wurde gesetzt in den Flaggen der Initialisierung Struktur für die entsprechenden Standarddialogfeld, Sie konnte jedoch einen Zeiger auf eine entsprechende Hook-Prozedur bereitstellen. |
| CDERR_NOTEMPLATE | Das Attribut ENABLETEMPLATE wurde in den Flaggen der Initialisierung Struktur für die entsprechenden Standarddialogfeld, aber Sie konnte keine entsprechende Vorlage bereitstellen. |
| CDERR_REGISTERMSGFAIL | Die RegisterWindowMessage -Funktion hat einen Fehlercode zurückgegeben, wenn sie von der gemeinsamen Dialog Feld Funktion aufgerufen wurde. |
| CDERR_STRUCTSIZE | Das lStructSize -Mitglied der Initialisierung Struktur für die entsprechenden Standarddialogfeld ist ungültig. |
Die folgenden Fehlercodes können für die PrintDlg -Funktion zurückgegeben werden:
| Wert | Bedeutung |
|---|---|
| PDERR_CREATEICFAILURE | Die PrintDlg -Funktion ist fehlgeschlagen, wenn es versucht, einen Informationskontext erstellen. |
| PDERR_DEFAULTDIFFERENT | Sie rief die PrintDlg -Funktion mit dem DN_DEFAULTPRN-Flag in der wDefault -Member der Struktur DEVNAMES angegebenen, aber der Drucker von den anderen Mitgliedern der Struktur beschrieben nicht die aktuellen Standarddruckers überein. (Dieser Fehler tritt auf, wenn Sie die Struktur DEVNAMES und Speichern der Benutzer den Standarddrucker ändert mithilfe der Systemsteuerung.) |
| Um den Drucker beschrieben durch die DEVNAMES -Struktur verwenden, löschen Sie das DN_DEFAULTPRN-Flag und rufen PrintDlg erneut auf. Als Standarddrucker verwenden möchten, ersetzen Sie die Struktur DEVNAMES mit denen (und die die DEVMODE -Struktur, falls vorhanden) mit NULL; und rufen Sie erneut PrintDlg. |
|
| PDERR_DNDMMISMATCH | Die Daten in die DEVMODE und DEVNAMES -Struktur beschreibt zwei verschiedene Drucker. |
| PDERR_GETDEVMODEFAIL | Der Druckertreiber konnte eine DEVMODE -Struktur zu initialisieren. (Dieser Fehlercode gilt nur für Druckertreiber geschrieben für Windowsversion 3.0 und höher.) |
| PDERR_INITFAILURE | Die PrintDlg -Funktion während der Initialisierung fehlgeschlagen, und es gibt keine spezifischen erweiterten Fehlercode, den Fehler zu beschreiben. Dies ist der generische Standard-Fehler-Code für die Funktion. |
| PDERR_LOADDRVFAILURE | Die PrintDlg -Funktion konnte nicht geladen werden den Gerätetreiber für den angegebenen Drucker. |
| PDERR_NODEFAULTPRN | Ein Standarddrucker ist nicht vorhanden. |
| PDERR_NODEVICES | Keine Druckertreiber gefunden. |
| PDERR_PARSEFAILURE | Die PrintDlg -Funktion konnte die Zeichenfolgen im Abschnitt [Geräte] den Sieg zu analysieren.INI-Datei. |
| PDERR_PRINTERNOTFOUND | Der Abschnitt [Geräte] der WIN.INI-Datei keinen Eintrag für den angeforderten Drucker enthält. |
| PDERR_RETDEFFAILURE | Wurde das PD_RETURNDEFAULT Flag im Flags -Member die PRINTDLG -Struktur angegeben, aber das hDevMode oder hDevNames war nicht NULL. |
| PDERR_SETUPFAILURE | Die PrintDlg -Funktion Fehler beim Laden der erforderlichen Ressourcen. |
Die folgenden Fehlercodes können für die ChooseFont -Funktion zurückgegeben werden:
| Wert | Bedeutung |
|---|---|
| CFERR_MAXLESSTHANMIN | Die in der nSizeMax -Member der Struktur CHOOSEFONT angegebene Größe ist kleiner als die Größe angegeben in der nSizeMin -member. |
| CFERR_NOFONTS | Keine Schriftarten vorhanden. |
Die folgenden Fehlercodes können für die GetOpenFileName und GetSaveFileName -Funktion zurückgegeben werden:
| Wert | Bedeutung |
|---|---|
| FNERR_BUFFERTOOSMALL | Der Puffer, auf den der LpstrFile -Member der OPENFILENAME -Struktur ist zu klein für den vom Benutzer angegebenen Dateinamen. Die ersten zwei Bytes des Puffers LpstrFile enthält einen ganzzahligen Wert angeben, die Größe in Bytes (ANSI-Version) oder 16-Bit-Zeichen (Unicode-Version), benötigt, um den vollständigen Namen zu erhalten. |
| FNERR_INVALIDFILENAME | Ein Dateiname ist ungültig. |
| FNERR_SUBCLASSFAILURE | Versuch, Unterklasse ein Listenfeld ist fehlgeschlagen, weil nicht genügend Arbeitsspeicher verfügbar war. |
Der folgenden Fehlercode kann für die FindText und ReplaceText -Funktionen zurückgegeben werden:
| Wert | Bedeutung |
|---|---|
| FRERR_BUFFERLENGTHZERO | Ein Mitglied der FINDREPLACE -Struktur verweist auf einen ungültigen Puffer. |
Windows CE: Windows CE unterstützt vier zusätzliche Rückgabewerte
Die folgenden Rückgabewerte gelten nur für die PrintDlg -Funktion:
Windows CE unterstützt nicht die Rückgabewerte von CDERR_LOADSTRFAILURE, CDERR_MEMLOCKFAILURE oder CDERR_REGISTERMSGFAIL.
Windows CE unterstützt nicht die PDERR_ Fehler Werte.
&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Version 1.0 oder höher benötigt.
Header:In commdlg.h deklariert.
Importieren Bibliothek:Verwenden Sie comdlg32.lib.
Übersicht über Common Dialog Box Library Funktionen der Common Dialog Box, ChooseColor CHOOSECOLOR, ChooseFont, CHOOSEFONT, DEVMODE, DEVNAMES, DialogBox, FINDREPLACE, FindText, GetOpenFileName, GetSaveFileName, OPENFILENAME, PageSetupDlg, PAGESETUPDLG, PrintDlg, PRINTDLG, RegisterWindowMessage, ReplaceText