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)
Questa funzione non ha parametri.
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.
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
I valori restituiti seguenti si applicano solo alla funzione PrintDlg:
Windows CE non supporta i valori restituiti, CDERR_LOADSTRFAILURE, CDERR_MEMLOCKFAILURE o CDERR_REGISTERMSGFAIL.
Windows CE non supporta uno dei valori di errore PDERR_.
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.
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