Funzione CommDlgExtendedError (commdlg.h)
Restituisce un codice di errore comune della finestra di dialogo. Questo codice indica l'errore più recente che si verifica durante l'esecuzione di una delle funzioni comuni della finestra di dialogo.
Sintassi
DWORD CommDlgExtendedError();
Valore restituito
Tipo: DWORD
Se la chiamata più recente a una funzione di finestra di dialogo comune ha avuto esito positivo, il valore restituito non è definito. Se la funzione della finestra di dialogo comune ha restituito FALSE perché l'utente ha chiuso o annullato la finestra di dialogo, il valore restituito è zero. In caso contrario, il valore restituito è un codice di errore diverso da zero.
La funzione CommDlgExtendedError può restituire codici di errore generali per una delle funzioni comuni della finestra di dialogo. Sono inoltre presenti codici di errore restituiti solo per una finestra di dialogo comune specifica. Tutti questi codici di errore sono definiti in Cderr.h. I codici di errore generali seguenti possono essere restituiti per una delle funzioni comuni della finestra di dialogo.
| Codice/valore restituito | Descrizione |
|---|---|
|
Impossibile creare la finestra di dialogo. La chiamata della funzione della finestra di dialogo comune alla funzione DialogBox non è riuscita. Ad esempio, questo errore si verifica se la chiamata alla finestra di dialogo comune specifica un handle di finestra non valido. |
|
La funzione della finestra di dialogo comune non è riuscita a trovare una risorsa specificata. |
|
La funzione della finestra di dialogo comune non è riuscita durante l'inizializzazione. Questo errore si verifica spesso quando non è disponibile memoria sufficiente. |
|
La funzione della finestra di dialogo comune non è riuscita a caricare una risorsa specificata. |
|
La funzione della finestra di dialogo comune non è riuscita a caricare una stringa specificata. |
|
La funzione della finestra di dialogo comune non è riuscita a bloccare una risorsa specificata. |
|
La funzione della finestra di dialogo comune non è stata in grado di allocare memoria per le strutture interne. |
|
La funzione della finestra di dialogo comune non è riuscita a bloccare la memoria associata a un handle. |
|
Il flag ENABLETEMPLATE è stato impostato nel membro Flags della struttura di inizializzazione per la finestra di dialogo comune corrispondente, ma non è stato possibile fornire un handle di istanza corrispondente. |
|
Il flag ENABLEHOOK è stato impostato nel membro Flags della struttura di inizializzazione per la finestra di dialogo comune corrispondente, ma non è stato possibile fornire un puntatore a una routine hook corrispondente. |
|
Il flag ENABLETEMPLATE è stato impostato nel membro Flags della struttura di inizializzazione per la finestra di dialogo comune corrispondente, ma non è stato possibile specificare un modello corrispondente. |
|
La funzione RegisterWindowMessage ha restituito un codice di errore quando è stato chiamato dalla funzione della finestra di dialogo comune. |
|
Il membro lStructSize della struttura di inizializzazione per la finestra di dialogo comune corrispondente non è valido. |
È possibile restituire i codici di errore seguenti per la funzione PrintDlg .
| Codice/valore restituito | Descrizione |
|---|---|
|
La funzione PrintDlg non è riuscita quando ha tentato di creare un contesto informativo. |
|
È stata chiamata la funzione PrintDlg con il flag DN_DEFAULTPRN specificato nel membro wDefault della struttura DEVNAMES , ma la stampante descritta dagli altri membri della struttura non corrisponde alla stampante predefinita corrente. Questo errore si verifica quando si archivia la struttura DEVNAMES e l'utente modifica la stampante predefinita usando il Pannello di controllo.
Per utilizzare la stampante descritta dalla struttura DEVNAMES , deselezionare il flag DN_DEFAULTPRN e chiamare di nuovo PrintDlg . Per utilizzare la stampante predefinita, sostituire la struttura DEVNAMES (e la struttura, se presente) con NULL; e chiama di nuovo PrintDlg . |
|
I dati nelle strutture DEVMODE e DEVNAMES descrivono due stampanti diverse. |
|
Il driver della stampante non è riuscito a inizializzare una struttura DEVMODE . |
|
La funzione PrintDlg non è riuscita durante l'inizializzazione e non è disponibile codice di errore esteso più specifico per descrivere l'errore. Si tratta del codice di errore predefinito generico per la funzione. |
|
La funzione PrintDlg non è riuscita a caricare il driver di dispositivo per la stampante specificata. |
|
Non esiste una stampante predefinita. |
|
Non sono stati trovati driver della stampante. |
|
La funzione PrintDlg non è riuscita ad analizzare le stringhe nella sezione [devices] del file WIN.INI. |
|
La sezione [devices] del file WIN.INI non contiene una voce per la stampante richiesta. |
|
Il flag PD_RETURNDEFAULT è stato specificato nel membro Flags della struttura PRINTDLG , ma il membro hDevMode o hDevNames non è NULL. |
|
La funzione PrintDlg non è riuscita a caricare le risorse necessarie. |
È possibile restituire i codici di errore seguenti per la funzione ChooseFont .
| Codice/valore restituito | Descrizione |
|---|---|
|
La dimensione specificata nel membro nSizeMax della struttura CHOOSEFONT è minore della dimensione specificata nel membro nSizeMin . |
|
Nessun carattere esistente. |
I codici di errore seguenti possono essere restituiti per le funzioni GetOpenFileName e GetSaveFileName .
| Codice/valore restituito | Descrizione |
|---|---|
|
Il buffer a cui punta 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 che specifica le dimensioni necessarie per ricevere il nome completo, in caratteri. |
|
Nome file non valido. |
|
Tentativo di sottoclassare una casella di riepilogo non riuscita perché memoria sufficiente non era disponibile. |
È possibile restituire il codice di errore seguente per le funzioni FindText e ReplaceText .
| Codice/valore restituito | Descrizione |
|---|---|
|
Un membro della struttura FINDREPLACE punta a un buffer non valido. |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | commdlg.h (include Windows.h) |
| Libreria | Comdlg32.lib |
| DLL | Comdlg32.dll |
| Set di API | ext-ms-win-shell-comdlg32-l1-1-0 (introdotto in Windows 10, versione 10.0.10240) |
Vedi anche
Libreria delle finestre di dialogo comuni
Informazioni concettuali
Riferimento