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)
Funkcja ta ma bez parametrów.
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.
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
Zwraca następujące wartości stosuje się tylko do funkcji PrintDlg:
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_.
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.
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