CommDlgExtendedError

La funzione CommDlgExtendedError restituisce un codice di errore di casella di dialogo comuni. Questo codice indica l'errore più recente a verificarsi durante l'esecuzione di una delle seguenti funzioni di casella di dialogo comuni:

ChooseColor GetOpenFileName
ChooseFont GetSaveFileName
FindText PrintDlg
ReplaceText PageSetupDlg

DWORD CommDlgExtendedError(VOID)
 

Parametri

Questa funzione non ha parametri.

Valori restituiti

Se la chiamata più recente a una funzione comune di casella di dialogo riuscito, il valore restituito è definito.

Se la funzione di casella di dialogo comuni restituito FALSE perché l'utente chiuso o annullata nella finestra di dialogo, il valore restituito è zero. In caso contrario, il valore restituito è un codice di errore diverso da zero. Per ulteriori informazioni, vedere la sezione Osservazioni seguente.

Osservazioni

La funzione CommDlgExtendedError può restituire i codici di errore generale per una qualsiasi delle funzioni casella di dialogo comuni. Inoltre, ci sono i codici di errore restituiti solo per una dialogo comune specifico. I codici di errore restituiti da CommDlgExtendedError sono definiti nella CDERR.File H.

I seguenti codici di errore generale possono essere restituiti per una qualsiasi delle funzioni casella di dialogo comuni:

Valore Significato
CDERR_DIALOGFAILURE Nella finestra di dialogo non può essere creata. Chiamata della funzione comuni per la casella di dialogo alla funzione DialogBox riuscita. Ad esempio, questo errore si verifica se il comune di dialogo casella chiamata specifica un handle di finestra non valido.
CDERR_FINDRESFAILURE La funzione di casella di dialogo comuni non riuscì a trovare una risorsa specificata.
CDERR_INITIALIZATION La funzione di casella di dialogo comuni non riuscita durante l'inizializzazione. Questo errore si verifica spesso quando sufficiente memoria non è disponibile.
CDERR_LOADRESFAILURE La funzione comune di casella di dialogo Impossibile caricare una risorsa specificata.
CDERR_LOADSTRFAILURE La funzione comune di casella di dialogo Impossibile caricare una stringa specificata.
CDERR_LOCKRESFAILURE La funzione di casella di dialogo comuni non è riuscito a bloccare una risorsa specificata.
CDERR_MEMALLOCFAILURE La funzione di casella di dialogo comuni era impossibile allocare memoria per strutture interne.
CDERR_MEMLOCKFAILURE La funzione di casella di dialogo comuni non è riuscita a bloccare la memoria associata una maniglia.
CDERR_NOHINSTANCE È stato impostato il flag ENABLETEMPLATE nel membro Flags della struttura di inizializzazione per il corrispondente nella finestra di dialogo comuni, ma non siete riusciti a fornire un handle di istanza corrispondente.
CDERR_NOHOOK Il flag ENABLEHOOK è stato impostato nel membro Flags della struttura di inizializzazione per il corrispondente nella finestra di dialogo comuni, ma non siete riusciti a fornire un puntatore a una routine di hook corrispondente.
CDERR_NOTEMPLATE È stato impostato il flag ENABLETEMPLATE nel membro Flags della struttura di inizializzazione per il corrispondente nella finestra di dialogo comuni, ma non siete riusciti a fornire un modello corrispondente.
CDERR_REGISTERMSGFAIL La funzione RegisterWindowMessage restituito un codice di errore quando è stato chiamato dalla funzione casella di dialogo comuni.
CDERR_STRUCTSIZE Il membro lStructSize della struttura di inizializzazione per il corrispondente nella finestra di dialogo comune non è valido.

I seguenti codici di errore possono essere restituiti per la funzione PrintDlg:

Valore Significato
PDERR_CREATEICFAILURE La funzione PrintDlg fallì quando ha tentato di creare un contesto di informazioni.
PDERR_DEFAULTDIFFERENT Si chiama la funzione PrintDlg con il flag DN_DEFAULTPRN specificato nel membro wDefault della struttura DEVNAMES , ma la stampante descritta dagli altri membri di struttura non corrisponde la stampante predefinita corrente. (Questo errore si verifica quando si memorizzano la struttura DEVNAMES e l'utente modifica la stampante predefinita utilizzando il pannello di controllo.)
Per utilizzare la stampante descritta dalla struttura DEVNAMES , cancellare il flag DN_DEFAULTPRN e chiamare nuovamente PrintDlg.

Per utilizzare la stampante predefinita, sostituire la struttura DEVNAMES (e la struttura DEVMODE , se ne esiste uno) con NULL; e chiamare nuovamente PrintDlg.

PDERR_DNDMMISMATCH I dati delle strutture DEVMODE e DEVNAMES descrive due diverse stampanti.
PDERR_GETDEVMODEFAIL Il driver della stampante Impossibile inizializzare una struttura DEVMODE . (Questo codice di errore si applica solo per i driver della stampante scritti per Windows versione 3.0 e successivi).
PDERR_INITFAILURE La funzione PrintDlg non riuscita durante l'inizializzazione, e c'è il codice di errore esteso non più specifico per descrivere il fallimento. Questo è il codice di errore generico predefinito per la funzione.
PDERR_LOADDRVFAILURE La funzione PrintDlg Impossibile caricare il driver di periferica per la stampante specificata.
PDERR_NODEFAULTPRN Non esiste una stampante predefinita.
PDERR_NODEVICES È non stato trovato nessun driver della stampante.
PDERR_PARSEFAILURE La funzione PrintDlg Impossibile analizzare le stringhe nella sezione [dispositivi] la vittoria.File INI.
PDERR_PRINTERNOTFOUND La sezione [dispositivi] di vincere.File INI non conteneva una voce per la stampante richiesta.
PDERR_RETDEFFAILURE Il flag PD_RETURNDEFAULT è stato specificato nel membro Flags della struttura PRINTDLG , ma il membro hDevMode o hDevNames non era NULL.
PDERR_SETUPFAILURE La funzione PrintDlg non è riuscito a caricare le risorse necessarie.

I seguenti codici di errore possono essere restituiti per la funzione ChooseFont:

Valore Significato
CFERR_MAXLESSTHANMIN Le dimensioni specificate nel membro nSizeMax della struttura CHOOSEFONT sono inferiori a quelle specificate nel membro nSizeMin.
CFERR_NOFONTS Nessun font esistono.

I seguenti codici di errore possono essere restituiti per le funzioni GetOpenFileName e GetSaveFileName:

Valore Significato
FNERR_BUFFERTOOSMALL Il buffer a cui puntato il membro lpstrFile della struttura OPENFILENAME è troppo piccolo per il nome file specificato dall'utente. I primi due byte del buffer lpstrFile contengono un valore intero specificando la dimensione in byte (versione ANSI) o in caratteri (versione Unicode), a 16-bit necessari per ricevere il nome completo.
FNERR_INVALIDFILENAME Un nome di file non valido.
FNERR_SUBCLASSFAILURE Un tentativo di sottoclasse una casella di riepilogo non riuscito perché non è disponibile memoria sufficiente.

Il seguente codice di errore può essere restituito per le funzioni FindText e ReplaceText:

Valore Significato
FRERR_BUFFERLENGTHZERO Un membro della struttura FINDREPLACE punta a un buffer non valido.

Windows CE: Windows CE supporta quattro ulteriori valori restituiti

CDERR_REGISTRYFAILURE
La funzione di casella di dialogo comuni è riuscita a leggere dal Registro di sistema.

I valori restituiti seguenti si applicano solo alla funzione PrintDlg:

PDERR_NOPORTS
Porte non sono registrate.
PDERR_NOPRINTERS
Nessun stampanti sono registrati.
PDERR_CREATEDCFAILURE
La chiamata a CreateDC non riuscita.

Windows CE non supporta i valori restituiti, CDERR_LOADSTRFAILURE, CDERR_MEMLOCKFAILURE o CDERR_REGISTERMSGFAIL.

Windows CE non supporta uno dei valori di errore PDERR_.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Richiede Windows 95 o versioni successive.
Windows CE:Richiede la versione 1.0 o successiva.
Intestazione:Dichiarati in commdlg.h.
Importare librerie:Utilizzare comdlg32.lib.

Vedi anche

Comuni Dialog Box Library panoramica, funzioni di Box di dialogo comuni, ChooseColor, CHOOSECOLOR, ChooseFont, CHOOSEFONT, DEVMODE, DEVNAMES, DialogBox, FINDREPLACE, FindText, GetOpenFileName, GetSaveFileName, OPENFILENAME, PageSetupDlg, PAGESETUPDLG, PrintDlg, PRINTDLG, RegisterWindowMessage, ReplaceText