De functie CommDlgExtendedError retourneert een gemeenschappelijk dialoogvenster vak foutcode. Deze code geeft aan de meest recente fout optreden tijdens de uitvoering van een van de volgende gemeenschappelijke dialoogvenster vak functies:
| ChooseColor | GetOpenFileName |
| ChooseFont | GetSaveFileName |
| FindText | PrintDlg |
| ReplaceText | PageSetupDlg |
DWORD-CommDlgExtendedError(VOID)
Deze functie heeft geen parameters.
Als de meest recente aanroep naar een gemeenschappelijk dialoogvenster vak functie opgevolgd, is de geretourneerde waarde undefined.
Als de gemeenschappelijke dialoogvenster vak functie heeft onwaar geretourneerd omdat de gebruiker gesloten of geannuleerd in het dialoogvenster, is de retourwaarde nul. De retourwaarde is anders, een niet-nulzijnde foutcode. Voor meer informatie, zie de volgende sectie opmerkingen.
De CommDlgExtendedError functie kunt algemene foutcodes voor één van de gemeenschappelijke dialoogvenster vak functies terugkeren. Daarnaast zijn er foutcodes die alleen voor een specifieke common dialog box zijn opgehaald. De foutcodes geretourneerd door CommDlgExtendedError zijn in de CDERR gedefinieerd.H bestand.
De volgende algemene foutcodes kunnen worden geretourneerd voor een van de gemeenschappelijke dialoogvenster vak functies:
| Waarde | Betekenis |
|---|---|
| CDERR_DIALOGFAILURE | Het dialoogvenster kan niet worden gemaakt. Gemeenschappelijke dialoogvenster vak van de functie aanroep naar de functie DialogBox is mislukt. Deze fout treedt bijvoorbeeld op als de gemeenschappelijke dialoogvenster vak oproep een ongeldige vensteringang geeft. |
| CDERR_FINDRESFAILURE | De gemeenschappelijke dialoogvenster vak functie mislukt een opgegeven resource zoeken. |
| CDERR_INITIALIZATION | De gemeenschappelijke dialoogvenster vak functie is mislukt tijdens initialisatie. Deze fout treedt vaak op wanneer niet voldoende geheugen beschikbaar is. |
| CDERR_LOADRESFAILURE | De gemeenschappelijke dialoogvenster vak functie fout bij het laden van een opgegeven resource. |
| CDERR_LOADSTRFAILURE | De gemeenschappelijke dialoogvenster vak functie fout bij het laden van een opgegeven tekenreeks. |
| CDERR_LOCKRESFAILURE | De gemeenschappelijke dialoogvenster vak functie mislukt een opgegeven bron te locken. |
| CDERR_MEMALLOCFAILURE | De gemeenschappelijke dialoogvenster vak functie was geen geheugen toewijzen voor interne structuren. |
| CDERR_MEMLOCKFAILURE | De gemeenschappelijke dialoogvenster vak functie was niet in staat om te vergrendelen van het geheugen die is gekoppeld aan een handvat. |
| CDERR_NOHINSTANCE | De markering ENABLETEMPLATE in de vlaggen lid van de initialisatie structuur voor de overeenkomstige common dialog box was ingesteld, maar u niet bieden een overeenkomstige sessiehandler. |
| CDERR_NOHOOK | De markering ENABLEHOOK in de vlaggen lid van de initialisatie structuur voor de overeenkomstige common dialog box was ingesteld, maar u niet bieden een pointer naar een bijbehorende haak-procedure. |
| CDERR_NOTEMPLATE | De markering ENABLETEMPLATE in de vlaggen lid van de initialisatie structuur voor de overeenkomstige common dialog box was ingesteld, maar u niet bieden een corresponderende sjabloon. |
| CDERR_REGISTERMSGFAIL | De RegisterWindowMessage functie heeft een foutcode geretourneerd toen het werd genoemd door de gemeenschappelijke dialoogvenster vak functie. |
| CDERR_STRUCTSIZE | De lStructSize lid van de initialisatie structuur voor de overeenkomstige common dialog box is ongeldig. |
De volgende foutcodes kunnen worden geretourneerd voor de PrintDlg -functie:
| Waarde | Betekenis |
|---|---|
| PDERR_CREATEICFAILURE | De functie PrintDlg mislukt toen het probeerde te maken van een informatie-context. |
| PDERR_DEFAULTDIFFERENT | U de functie PrintDlg aangeroepen met de DN_DEFAULTPRN vlag in het lid wDefault van de structuur DEVNAMES betrekking hebben opgegeven, maar de printer beschreven door de andere leden van de structuur niet overeenkomt met de huidige standaardprinter. (Deze fout treedt op wanneer u de structuur DEVNAMES betrekking hebben slaan en de gebruiker de standaardinstellingen van de printer wijzigt met behulp van het Configuratiescherm.) |
| Als u de printer beschreven door de structuur DEVNAMES betrekking hebben , de DN_DEFAULTPRN markering wissen en bel PrintDlg opnieuw. Als u wilt de standaardprinter gebruikt, vervangt de structuur DEVNAMES betrekking hebben (en de de structuur DEVMODE, indien aanwezig ) met NULL; en bel opnieuw PrintDlg. |
|
| PDERR_DNDMMISMATCH | De gegevens in de structuur DEVMODE en DEVNAMES beschrijft twee verschillende printers. |
| PDERR_GETDEVMODEFAIL | Het printerstuurprogramma niet een DEVMODE -structuur initialiseren. (Deze foutcode geldt alleen voor printerstuurprogramma's geschreven voor Windows versie 3.0 en later). |
| PDERR_INITFAILURE | De PrintDlg functie is mislukt tijdens initialisatie, en er is niet meer specifieke uitgebreide foutcode om te beschrijven de mislukking. Dit is de generieke standaard error code voor de functie. |
| PDERR_LOADDRVFAILURE | De functie PrintDlg fout bij het laden van het apparaatstuurprogramma voor de opgegeven printer. |
| PDERR_NODEFAULTPRN | Een standaardprinter bestaat niet. |
| PDERR_NODEVICES | Geen printerstuurprogramma's werden gevonden. |
| PDERR_PARSEFAILURE | De functie PrintDlg mislukt om te ontleden de tekenreeksen in de sectie [devices] voor de overwinning.INI-bestand. |
| PDERR_PRINTERNOTFOUND | De sectie [devices] van de overwinning.INI-bestand bevatte geen een vermelding voor de gevraagde printer. |
| PDERR_RETDEFFAILURE | De vlag PD_RETURNDEFAULT is opgegeven in de vlaggen lid van de PRINTDLG structuur, de hDevMode of hDevNames -lid was, maar niet NULL. |
| PDERR_SETUPFAILURE | De functie PrintDlg niet laden de vereiste resources. |
De volgende foutcodes kunnen worden geretourneerd voor de ChooseFont -functie:
| Waarde | Betekenis |
|---|---|
| CFERR_MAXLESSTHANMIN | De grootte die is opgegeven in het lid nSizeMax van de CHOOSEFONT structuur is lager is dan de grootte die is opgegeven in de nSizeMin lid. |
| CFERR_NOFONTS | Geen lettertypen bestaan. |
De volgende foutcodes kunnen worden geretourneerd voor de functies GetOpenFileName en GetSaveFileName:
| Waarde | Betekenis |
|---|---|
| FNERR_BUFFERTOOSMALL | De buffer waarnaar wordt verwezen door het lid lpstrFile van de NAAMOPENBESTAND structuur is te klein voor de door de gebruiker opgegeven bestandsnaam. De eerste twee bytes van de buffer lpstrFile bevatten een integer-waarde die aangeeft de grootte, in bytes (ANSI-versie) of 16-bits tekens (Unicode versie), nodig voor het ontvangen van de volledige naam. |
| FNERR_INVALIDFILENAME | Een bestandsnaam is ongeldig. |
| FNERR_SUBCLASSFAILURE | Een poging tot subklasse een keuzelijst is mislukt omdat er niet voldoende geheugen beschikbaar was. |
De volgende foutcode weergegeven kan worden opgehaald voor de functies FindText en ReplaceText:
| Waarde | Betekenis |
|---|---|
| FRERR_BUFFERLENGTHZERO | Een lid van de FINDREPLACE structuur verwijst naar een ongeldige buffer. |
Windows CE: Windows CE ondersteunt vier extra retourwaarden
De volgende retourwaarden gelden alleen voor de PrintDlg -functie:
Windows CE biedt geen ondersteuning voor de CDERR_LOADSTRFAILURE, CDERR_MEMLOCKFAILURE of CDERR_REGISTERMSGFAIL retourwaarden.
Windows CE biedt geen ondersteuning voor een van de foutwaarden van PDERR_.
nbsp; Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Versie 1.0 of hoger vereist.
Header:Verklaard in commdlg.h.
Bibliotheek importeren:Gebruik comdlg32.lib.
Overzicht van bibliotheek het gemeenschappelijk dialoogvenster, gemeenschappelijk dialoogvenster vak functies, ChooseColor, CHOOSECOLOR, ChooseFont, CHOOSEFONT, DEVMODE, DEVNAMES, DialogBox, FINDREPLACE, FindText, GetOpenFileName, GetSaveFileName, OPENBESTANDSNAAM, PageSetupDlg, PAGESETUPDLG, PrintDlg, PRINTDLG, RegisterWindowMessage, ReplaceText