CommDlgExtendedError

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)
 

Parameters

Deze functie heeft geen parameters.

Retourwaarden

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.

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

CDERR_REGISTRYFAILURE
De gemeenschappelijke dialoogvenster vak functie was niet in staat om te lezen uit register.

De volgende retourwaarden gelden alleen voor de PrintDlg -functie:

PDERR_NOPORTS
Geen poorten zijn geregistreerd.
PDERR_NOPRINTERS
Geen printers zijn geregistreerd.
PDERR_CREATEDCFAILURE
Het aanroepen van CreateDC mislukt.

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_.

Syntaxisinfo

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.

Zie ook

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