CommDlgExtendedError

Funkcja CommDlgExtendedError zwraca wspólny kod błędu pole dialogowe. Ten kod wskazuje ostatni błąd wystąpi podczas wykonywania jednej z następujących funkcji pole wspólne okno dialogowe:

ChooseColor GetOpenFileName
ChooseFont GetSaveFileName
FindText PrintDlg
ReplaceText PageSetupDlg

DWORD CommDlgExtendedError(VOID)

 

Parametry

Funkcja ta ma bez parametrów.

Zwraca wartości

Jeśli udało się ostatnie wywołanie wspólnej funkcji pole dialogowe, wartość zwracany jest niezdefiniowana.

Jeśli funkcję pole wspólne okno dialogowe zwrócona wartość FALSE, ponieważ zamknięte lub anulowane okno dialogowe użytkownika, wartość zwracany jest równa zero. W przeciwnym razie wartość zwracany jest kod błędu niezerową. Aby uzyskać więcej informacji zobacz następującą sekcję Uwagi.

Uwagi

Funkcję CommDlgExtendedError można zwrócić błąd ogólny kody dla każdego z typowych funkcji pole dialogowe. Ponadto istnieją kodów błędów, które są zwracane tylko dla określonych wspólne okno dialogowe. Kody błędów zwracanych przez CommDlgExtendedError są zdefiniowane w CDERR.H pliku.

Następujące kody błędów ogólne mogą być zwracane dla każdego z typowych funkcji pole dialogowe:

Wartość Znaczenie
CDERR_DIALOGFAILURE Nie można utworzyć okna dialogowego. Wspólne okno dialogowe pole funkcji przez wywołanie funkcji DialogBox nie powiodło się. Na przykład ten błąd występuje, jeśli wspólnej rozmowy pole dialogowe określa dojście do okna nieprawidłowy.
CDERR_FINDRESFAILURE Funkcję pole wspólne okno dialogowe nie udało się znaleźć określonego zasobu.
CDERR_INITIALIZATION Funkcję pole wspólne okno dialogowe nie powiodło się podczas inicjowania. Ten błąd występuje często, gdy nie jest dostępna wystarczająco duża pamięć.
CDERR_LOADRESFAILURE Funkcję pole wspólne okno dialogowe nie udało się załadować określonego zasobu.
CDERR_LOADSTRFAILURE Funkcję pole wspólne okno dialogowe nie udało się załadować określony ciąg.
CDERR_LOCKRESFAILURE Funkcję pole wspólne okno dialogowe nie udało się zablokować określonego zasobu.
CDERR_MEMALLOCFAILURE Funkcję pole wspólne okno dialogowe nie był w stanie przydzielić pamięci dla struktury wewnętrznej.
CDERR_MEMLOCKFAILURE Funkcję pole wspólne okno dialogowe nie mógł zablokować pamięci skojarzonej z uchwytem.
CDERR_NOHINSTANCE Członek flag struktury inicjujące odpowiednich wspólnego okna dialogowego została ustawiona flaga ENABLETEMPLATE, ale udało się dostarczyć odpowiedni uchwyt wystąpienia.
CDERR_NOHOOK Członek flag struktury inicjujące odpowiednich wspólnego okna dialogowego została ustawiona flaga funkcja ENABLEHOOK, ale nie dostarczyło wskaźnika do odpowiednich procedura haka.
CDERR_NOTEMPLATE Członek flag struktury inicjujące odpowiednich wspólnego okna dialogowego została ustawiona flaga ENABLETEMPLATE, ale udało się dostarczyć odpowiedniego szablonu.
CDERR_REGISTERMSGFAIL Funkcja RegisterWindowMessage zwrócił kod błędu, gdy została wywołana przez funkcję pole wspólne okno dialogowe.
CDERR_STRUCTSIZE Członek lStructSize struktury inicjujące odpowiednich wspólnego okna dialogowego jest nieprawidłowy.

Następujące kody błędów mogą być zwracane dla funkcji PrintDlg:

Wartość Znaczenie
PDERR_CREATEICFAILURE Funkcja PrintDlg nie powiodła się podczas próby utworzenia kontekście informacji.
PDERR_DEFAULTDIFFERENT Wywołujesz funkcję PrintDlg z flagą DN_DEFAULTPRN, określonych w Państwa wDefault struktury DEVNAMES. , ale drukarki opisanego przez innego elementów konstrukcji nie odpowiada bieżącej drukarki domyślnej. (Błąd ten wystąpi podczas przechowywania struktury DEVNAMES i użytkownik zmieni domyślną drukarkę za pomocą panelu sterowania.)
Aby użyć drukarki opisanego przez konstrukcję DEVNAMES. , czyści flagę DN_DEFAULTPRN i ponownie wywołać PrintDlg.

Aby użyć domyślnej drukarki, należy zastąpić struktury DEVNAMES. (i struktury DEVMODE , jeśli taki istnieje) z NULL; i ponownie wywołać PrintDlg.

PDERR_DNDMMISMATCH Dane w struktury DEVMODE i DEVNAMES opis dwóch różnych drukarek.
PDERR_GETDEVMODEFAIL Sterownik drukarki nie może zainicjować struktury DEVMODE . (Ten kod błędu dotyczy tylko do sterowników drukarek napisane dla Windows wersja 3.0 i nowsze).
PDERR_INITFAILURE Funkcja PrintDlg nie powiodła się; wystąpił błąd podczas inicjowania, i nie jest już określony kod błędu rozszerzonego do opisania awarii. Jest to kod błędu domyślne rodzajowego funkcji.
PDERR_LOADDRVFAILURE Funkcja PrintDlg nie udało się załadować sterownik urządzenia do określonej drukarki.
PDERR_NODEFAULTPRN Drukarka domyślna nie istnieje.
PDERR_NODEVICES Stwierdzono, że nie sterowników drukarek.
PDERR_PARSEFAILURE Funkcja PrintDlg nie powiodła się do analizowania ciągów w sekcji [devices] ZWYCIĘSTWO.Plik INI.
PDERR_PRINTERNOTFOUND W sekcji [devices] ZWYCIĘSTWO.Plik INI nie zawiera wpisu dla żądanej drukarki.
PDERR_RETDEFFAILURE Flaga PD_RETURNDEFAULT została określona w członek flag struktury PRINTDLG , ale Członkowskie pole hDevMode lub hDevNames nie była zerowa.
PDERR_SETUPFAILURE Funkcja PrintDlg nie może załadować wymaganych zasobów.

Następujące kody błędów mogą być zwracane dla funkcji ChooseFont:

Wartość Znaczenie
CFERR_MAXLESSTHANMIN Rozmiar określony w elemencie nSizeMax struktury CHOOSEFONT jest mniejszy niż rozmiar określony w elemencie nSizeMin.
CFERR_NOFONTS Istnieją żadnych czcionek.

Następujące kody błędów mogą być zwracane dla funkcji GetOpenFileName i GetSaveFileName:

Wartość Znaczenie
FNERR_BUFFERTOOSMALL Bufor wskazywanego przez członka lpstrFile struktury OPENFILENAME jest za mały dla nazwy pliku określonej przez użytkownika. Pierwsze dwa bajty bufora lpstrFile zawierają wartość całkowitą określającą, rozmiar, w bajtach (wersja ANSI) lub znaków 16-bitowych (wersja Unicode), wymagane do otrzymania pełnej nazwy.
FNERR_INVALIDFILENAME Nazwa pliku jest nieprawidłowa.
FNERR_SUBCLASSFAILURE Próba podklasy pole listy powiodła się, ponieważ nie była dostępna wystarczająco duża pamięć.

Następujący kod błędu może być zwrócona dla funkcji FindText i ReplaceText:

Wartość Znaczenie
FRERR_BUFFERLENGTHZERO Członek struktury FINDREPLACE wskazuje nieprawidłowy bufor.

Systemu Windows CE: Windows CE obsługuje cztery dodatkowe zwracane wartości

CDERR_REGISTRYFAILURE
Funkcję pole wspólne okno dialogowe nie był w stanie odczytać z rejestru.

Zwraca następujące wartości stosuje się tylko do funkcji PrintDlg:

PDERR_NOPORTS
Nie ma portów są zarejestrowane.
PDERR_NOPRINTERS
Brak drukarek są zarejestrowane.
PDERR_CREATEDCFAILURE
Wywołanie CreateDC nie powiodło się.

Windows CE nie obsługuje wartości zwracanej CDERR_LOADSTRFAILURE, CDERR_MEMLOCKFAILURE lub CDERR_REGISTERMSGFAIL.

Windows CE nie obsługuje żadnego z wartości błędu PDERR_.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w commdlg.h.
Importowanie biblioteki:Użycie comdlg32.lib.

Zobacz też

Wspólny omówienie biblioteki okna dialogowego, wspólne funkcje pole dialogowe, ChooseColor, CHOOSECOLOR, ChooseFont, CHOOSEFONT, DEVMODE, DEVNAMES., DialogBox, FINDREPLACE, FindText, GetOpenFileName, GetSaveFileName, OPENFILENAME, PageSetupDlg, PAGESETUPDLG, PrintDlg, PRINTDLG, RegisterWindowMessage, ReplaceText