CommDlgExtendedError-Funktion (commdlg.h)
Gibt einen allgemeinen Dialogfeldfehlercode zurück. Dieser Code gibt den letzten Fehler an, der während der Ausführung einer der allgemeinen Dialogfeldfunktionen auftritt.
Syntax
DWORD CommDlgExtendedError();
Rückgabewert
Art: DWORD
Wenn der letzte Aufruf einer allgemeinen Dialogfeldfunktion erfolgreich war, ist der Rückgabewert nicht definiert. Wenn die allgemeine Dialogfeldfunktion FALSE zurückgegeben hat, weil der Benutzer das Dialogfeld geschlossen oder abgebrochen hat, ist der Rückgabewert null. Andernfalls ist der Rückgabewert ein Fehlercode ungleich null.
Die CommDlgExtendedError-Funktion kann allgemeine Fehlercodes für alle gängigen Dialogfeldfunktionen zurückgeben. Darüber hinaus gibt es Fehlercodes, die nur für ein bestimmtes allgemeines Dialogfeld zurückgegeben werden. Alle diese Fehlercodes sind in Cderr.h definiert. Die folgenden allgemeinen Fehlercodes können für alle gängigen Dialogfeldfunktionen zurückgegeben werden.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Das Dialogfeld konnte nicht erstellt werden. Fehler beim Aufruf der DialogBox-Funktion der allgemeinen Dialogfeldfunktion. Dieser Fehler tritt beispielsweise auf, wenn der allgemeine Dialogfeldaufruf ein ungültiges Fensterhandle angibt. |
|
Die allgemeine Dialogfeldfunktion konnte eine angegebene Ressource nicht finden. |
|
Die allgemeine Dialogfeldfunktion ist während der Initialisierung fehlgeschlagen. Dieser Fehler tritt häufig auf, wenn nicht genügend Arbeitsspeicher verfügbar ist. |
|
Die allgemeine Dialogfeldfunktion konnte eine angegebene Ressource nicht laden. |
|
Die allgemeine Dialogfeldfunktion konnte eine angegebene Zeichenfolge nicht laden. |
|
Die allgemeine Dialogfeldfunktion konnte eine angegebene Ressource nicht sperren. |
|
Die allgemeine Dialogfeldfunktion konnte keinen Speicher für interne Strukturen zuweisen. |
|
Die allgemeine Dialogfeldfunktion konnte den speicher, der einem Handle zugeordnet ist, nicht sperren. |
|
Das ENABLETEMPLATE-Flag wurde im Flags-Element der Initialisierungsstruktur für das entsprechende allgemeine Dialogfeld festgelegt, aber Sie konnten kein entsprechendes instance-Handle angeben. |
|
Das ENABLEHOOK-Flag wurde im Flags-Member der Initialisierungsstruktur für das entsprechende allgemeine Dialogfeld festgelegt, aber Sie konnten keinen Zeiger auf eine entsprechende Hookprozedur angeben. |
|
Das ENABLETEMPLATE-Flag wurde im Flags-Element der Initialisierungsstruktur für das entsprechende allgemeine Dialogfeld festgelegt, aber Sie konnten keine entsprechende Vorlage bereitstellen. |
|
Die RegisterWindowMessage-Funktion hat einen Fehlercode zurückgegeben, wenn sie von der allgemeinen Dialogfeldfunktion aufgerufen wurde. |
|
Der lStructSize-Member der Initialisierungsstruktur für das entsprechende allgemeine Dialogfeld ist ungültig. |
Die folgenden Fehlercodes können für die PrintDlg-Funktion zurückgegeben werden.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Die PrintDlg-Funktion ist beim Versuch, einen Informationskontext zu erstellen, fehlgeschlagen. |
|
Sie haben die PrintDlg-Funktion mit dem im wDefault-Element der DEVNAMES-Struktur angegebenen DN_DEFAULTPRN-Flag aufgerufen, aber der drucker, der von den anderen Strukturelementen beschrieben wird, stimmte nicht mit dem aktuellen Standarddrucker überein. Dieser Fehler tritt auf, wenn Sie die DEVNAMES-Struktur speichern und der Benutzer den Standarddrucker mithilfe des Systemsteuerung ändert.
Um den drucker zu verwenden, der von der DEVNAMES-Struktur beschrieben wird, deaktivieren Sie das Flag DN_DEFAULTPRN , und rufen Sie PrintDlg erneut auf. Um den Standarddrucker zu verwenden, ersetzen Sie die DEVNAMES-Struktur (und die Struktur, falls vorhanden) durch NULL. und rufen Sie PrintDlg erneut auf. |
|
Die Daten in den DEVMODE - und DEVNAMES-Strukturen beschreiben zwei verschiedene Drucker. |
|
Der Druckertreiber konnte eine DEVMODE-Struktur nicht initialisieren. |
|
Die PrintDlg-Funktion ist während der Initialisierung fehlgeschlagen, und es gibt keinen spezifischeren erweiterten Fehlercode zur Beschreibung des Fehlers. Dies ist der generische Standardfehlercode für die Funktion. |
|
Die PrintDlg-Funktion konnte den Gerätetreiber für den angegebenen Drucker nicht laden. |
|
Ein Standarddrucker ist nicht vorhanden. |
|
Es wurden keine Druckertreiber gefunden. |
|
Die PrintDlg-Funktion konnte die Zeichenfolgen im Abschnitt [geräte] der datei WIN.INI nicht analysieren. |
|
Der Abschnitt [geräte] der WIN.INI-Datei enthielt keinen Eintrag für den angeforderten Drucker. |
|
Das PD_RETURNDEFAULT-Flag wurde im Flags-Member der PRINTDLG-Struktur angegeben, aber das Element hDevMode oder hDevNames war nicht NULL. |
|
Die PrintDlg-Funktion konnte die erforderlichen Ressourcen nicht laden. |
Die folgenden Fehlercodes können für die ChooseFont-Funktion zurückgegeben werden.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Die im nSizeMax-Member der CHOOSEFONT-Struktur angegebene Größe ist kleiner als die im nSizeMin-Element angegebene Größe. |
|
Es sind keine Schriftarten vorhanden. |
Die folgenden Fehlercodes können für die Funktionen GetOpenFileName und GetSaveFileName zurückgegeben werden.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Der Puffer, auf den der lpstrFile-Member der OPENFILENAME-Struktur verweist, ist für den vom Benutzer angegebenen Dateinamen zu klein. Die ersten beiden Bytes des lpstrFile-Puffers enthalten einen ganzzahligen Wert, der die größe angibt, die erforderlich ist, um den vollständigen Namen in Zeichen zu erhalten. |
|
Ein Dateiname ist ungültig. |
|
Fehler beim Unterklassen eines Listenfelds, weil nicht genügend Arbeitsspeicher verfügbar war. |
Der folgende Fehlercode kann für die Funktionen FindText und ReplaceText zurückgegeben werden.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Ein Member der FINDREPLACE-Struktur zeigt auf einen ungültigen Puffer. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | commdlg.h (windows.h einschließen) |
| Bibliothek | Comdlg32.lib |
| DLL | Comdlg32.dll |
| APIs | ext-ms-win-shell-comdlg32-l1-1-0 (eingeführt in Windows 10, Version 10.0.10240) |
Weitere Informationen
Allgemeine Dialogfeldbibliothek
Konzept
Referenz