CommDlgExtendedError funcția întoarce un comune cod de eroare pentru caseta de dialog. Acest cod arată cele mai recente eroare să apară în timpul executării unei funcții caseta de dialog următoarele comune:
| ChooseColor | GetOpenFileName |
| ChooseFont | GetSaveFileName |
| FindText | PrintDlg |
| ReplaceText | PageSetupDlg |
DWORD CommDlgExtendedError(VOID)
Această funcție are parametri nu.
În cazul în care cel mai recent apel la o funcție de caseta de dialog comune a reușit, valoarea returnată este nedefinit.
Dacă funcția comune pentru caseta de dialog întors FALSE deoarece utilizatorul a închis sau anulat caseta de dialog, valoarea returnată este zero. În caz contrar, valoarea returnată este un cod de eroare interior/exterior nenul. Pentru mai multe informații, consultați secțiunea observa?ii următoarele.
Funcția CommDlgExtendedError poate reveni codurile de eroare generale pentru oricare dintre funcții comune pentru caseta de dialog. În plus, acolo sunt codurile de eroare care sunt returnate numai pentru o casetă de dialog comune specifice. Codurile de eroare returnat de CommDlgExtendedError sunt definite în CDERR.Fișier H.
Următoarele coduri de eroare generale pot fi returnate pentru oricare dintre funcții comune pentru caseta de dialog:
| Valoarea | Sensul |
|---|---|
| CDERR_DIALOGFAILURE | Caseta de dialog nu ar putea fi create. Funcția comune pentru caseta de dialog apel la funcția de DialogBox nu a reușit. De exemplu, această eroare se produce dacă comune apelul caseta de dialog specifică un mâner de fereastră incorecte. |
| CDERR_FINDRESFAILURE | Funcția de caseta de dialog comun nu a reușit să găsească o resursa specificată. |
| CDERR_INITIALIZATION | Funcția de caseta de dialog comun nu a reușit în timpul inițializării. Această eroare apare deseori atunci când nu există suficientă memorie. |
| CDERR_LOADRESFAILURE | Funcția de caseta de dialog comun failed to load o resursa specificată. |
| CDERR_LOADSTRFAILURE | Funcția de caseta de dialog comun failed to load șir de caractere specificat. |
| CDERR_LOCKRESFAILURE | Funcția de caseta de dialog comun nu a reușit pentru a bloca o resursa specificată. |
| CDERR_MEMALLOCFAILURE | Funcția comune pentru caseta de dialog a fost imposibil de alocat memorie pentru structurile interne. |
| CDERR_MEMLOCKFAILURE | Funcția comune pentru caseta de dialog a fost imposibilitatea de a bloca de memorie asociate cu un mâner. |
| CDERR_NOHINSTANCE | Pavilionul ENABLETEMPLATE a fost stabilită în membre steaguri din structura de inițializare pentru caseta de dialog corespunzătoare comune, dar nu a reușit să ofere un mâner exemplu corespunzătoare. |
| CDERR_NOHOOK | Pavilionul ENABLEHOOK a fost stabilită în membre steaguri din structura de inițializare pentru caseta de dialog corespunzătoare comune, dar nu a reușit să furnizeze un pointer la o procedură corespunzătoare de cârlig. |
| CDERR_NOTEMPLATE | Pavilionul ENABLETEMPLATE a fost stabilită în membre steaguri din structura de inițializare pentru caseta de dialog corespunzătoare comune, dar nu a reușit să ofere un șablon corespunzătoare. |
| CDERR_REGISTERMSGFAIL | Funcția RegisterWindowMessage a returnat un cod de eroare atunci când a fost numit de funcția de caseta de dialog comune. |
| CDERR_STRUCTSIZE | LStructSize structura de inițializare pentru caseta de dialog comun corespunzătoare este nevalid. |
Următoarele coduri de eroare pot fi întoarse de funcția PrintDlg:
| Valoarea | Sensul |
|---|---|
| PDERR_CREATEICFAILURE | Funcția de PrintDlg nu a reușit atunci când a încercat să creeze un context de informații. |
| PDERR_DEFAULTDIFFERENT | Ai sunat funcția PrintDlg cu steagul DN_DEFAULTPRN specificate în membre wDefault din structura DEVNAMES , dar imprimanta descrise de ceilal?i membri structura nu corespunde imprimanta implicită curentă. (Această eroare apare atunci când stocați structura DEVNAMES și utilizatorul modifică imprimantă implicită utilizând panoul de Control). |
| Pentru a utiliza imprimanta descrisă de structura DEVNAMES , goliți pavilion DN_DEFAULTPRN și call PrintDlg din nou. Pentru a utiliza imprimanta implicită, înlocui structura DEVNAMES (și mod dezvoltare structura, dacă există unul) cu NULL; și de apel din nou PrintDlg. |
|
| PDERR_DNDMMISMATCH | Datele în mod dezvoltare și DEVNAMES structurile descrie două imprimante diferite. |
| PDERR_GETDEVMODEFAIL | Driverul de imprimantă nu a reu?it ini?ializarea o structură mod dezvoltare . (Acest cod de eroare se aplică numai pentru driverele de imprimantă scrisă pentru Windows versiunea 3.0 sau o versiune ulterioară). |
| PDERR_INITFAILURE | Funcția PrintDlg nu a reușit în timpul inițializării, și nu există nu mai specifice codul de eroare prelungit pentru a descrie eșecul. Acest lucru este codul de eroare generică implicit pentru funcția de. |
| PDERR_LOADDRVFAILURE | Funcția PrintDlg nu a reușit să se încarce driverul de dispozitiv pentru imprimanta specificată. |
| PDERR_NODEFAULTPRN | Nu există o imprimantă implicită. |
| PDERR_NODEVICES | Drivere de imprimantă nu s-au găsit. |
| PDERR_PARSEFAILURE | Funcția PrintDlg nu a reu?it să analizeze siruri de caractere în secțiunea [devices] de a câștiga.Fișierul INI. |
| PDERR_PRINTERNOTFOUND | Secțiunea [devices] de a câștiga.Fișierul INI nu con?ine o intrare pentru imprimanta solicitate. |
| PDERR_RETDEFFAILURE | Pavilionul PD_RETURNDEFAULT s-a specificat în membre steaguri de structura PRINTDLG , dar membru hDevMode sau hDevNames nu a fost NULL. |
| PDERR_SETUPFAILURE | Funcția PrintDlg failed to load resursele necesare. |
Următoarele coduri de eroare pot fi întoarse de funcția ChooseFont:
| Valoarea | Sensul |
|---|---|
| CFERR_MAXLESSTHANMIN | Dimensiunea specificată în membre nSizeMax din structura CHOOSEFONT este mai mică decât dimensiunea specificată în membru nSizeMin. |
| CFERR_NOFONTS | Fonturile nu există. |
Următoarele coduri de eroare pot fi întoarse pentru funcțiile GetOpenFileName și GetSaveFileName:
| Valoarea | Sensul |
|---|---|
| FNERR_BUFFERTOOSMALL | Tampon a subliniat de membru lpstrFile din structura OPENFILENAME este prea mic pentru numele de fișier specificat de utilizator. Primul doi octeți din tampon lpstrFile conțin un întreg valoare specifică dimensiunea, în octeți (ANSI versiunea) sau 16-bit caractere (versiunea Unicode), necesare pentru a primi numele complet. |
| FNERR_INVALIDFILENAME | Un nume de fișier nu este valid. |
| FNERR_SUBCLASSFAILURE | O încercare de a subclasă o casetă listă a e?uat deoarece nu era disponibilă suficientă memorie. |
Următorul cod de eroare pot fi întoarse pentru funcțiile FindText și ReplaceText:
| Valoarea | Sensul |
|---|---|
| FRERR_BUFFERLENGTHZERO | Puncte de membru din structura FINDREPLACE o tampon nevalid. |
Windows CE: Windows CE acceptă patru valori de returnare suplimentare
Următoarele valori de returnare se aplică numai funcția PrintDlg:
Windows CE nu acceptă valorile de returnare CDERR_LOADSTRFAILURE, CDERR_MEMLOCKFAILURE sau CDERR_REGISTERMSGFAIL.
Windows CE nu are suport pentru oricare din valorile de eroare PDERR_.
nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Necesită versiunea 1.0 sau mai târziu.
Antet:A declarat în commdlg.h.
Import Biblioteca:Utilizarea comdlg32.lib.
Comune Dialog Box biblioteca prezentare generală, funcții comune de caseta de Dialog, ChooseColor, CHOOSECOLOR, ChooseFont, CHOOSEFONT, mod dezvoltare, DEVNAMES, DialogBox, FINDREPLACE, FindText, GetOpenFileName, GetSaveFileName, OPENFILENAME, PageSetupDlg, PAGESETUPDLG, PrintDlg, PRINTDLG, RegisterWindowMessage, ReplaceText