Condividi tramite


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
CDERR_DIALOGFAILURE
0xFFFF
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.
CDERR_FINDRESFAILURE
0x0006
La funzione della finestra di dialogo comune non è riuscita a trovare una risorsa specificata.
CDERR_INITIALIZATION
0x0002
La funzione della finestra di dialogo comune non è riuscita durante l'inizializzazione. Questo errore si verifica spesso quando non è disponibile memoria sufficiente.
CDERR_LOADRESFAILURE
0x0007
La funzione della finestra di dialogo comune non è riuscita a caricare una risorsa specificata.
CDERR_LOADSTRFAILURE
0x0005
La funzione della finestra di dialogo comune non è riuscita a caricare una stringa specificata.
CDERR_LOCKRESFAILURE
0x0008
La funzione della finestra di dialogo comune non è riuscita a bloccare una risorsa specificata.
CDERR_MEMALLOCFAILURE
0x0009
La funzione della finestra di dialogo comune non è stata in grado di allocare memoria per le strutture interne.
CDERR_MEMLOCKFAILURE
0x000A
La funzione della finestra di dialogo comune non è riuscita a bloccare la memoria associata a un handle.
CDERR_NOHINSTANCE
0x0004
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.
CDERR_NOHOOK
0x000B
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.
CDERR_NOTEMPLATE
0x0003
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.
CDERR_REGISTERMSGFAIL
0x000C
La funzione RegisterWindowMessage ha restituito un codice di errore quando è stato chiamato dalla funzione della finestra di dialogo comune.
CDERR_STRUCTSIZE
0x0001
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
PDERR_CREATEICFAILURE
0x100A
La funzione PrintDlg non è riuscita quando ha tentato di creare un contesto informativo.
PDERR_DEFAULTDIFFERENT
0x100C
È 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 .

PDERR_DNDMMISMATCH
0x1009
I dati nelle strutture DEVMODE e DEVNAMES descrivono due stampanti diverse.
PDERR_GETDEVMODEFAIL
0x1005
Il driver della stampante non è riuscito a inizializzare una struttura DEVMODE .
PDERR_INITFAILURE
0x1006
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.
PDERR_LOADDRVFAILURE
0x1004
La funzione PrintDlg non è riuscita a caricare il driver di dispositivo per la stampante specificata.
PDERR_NODEFAULTPRN
0x1008
Non esiste una stampante predefinita.
PDERR_NODEVICES
0x1007
Non sono stati trovati driver della stampante.
PDERR_PARSEFAILURE
0x1002
La funzione PrintDlg non è riuscita ad analizzare le stringhe nella sezione [devices] del file WIN.INI.
PDERR_PRINTERNOTFOUND
0x100B
La sezione [devices] del file WIN.INI non contiene una voce per la stampante richiesta.
PDERR_RETDEFFAILURE
0x1003
Il flag PD_RETURNDEFAULT è stato specificato nel membro Flags della struttura PRINTDLG , ma il membro hDevMode o hDevNames non è NULL.
PDERR_SETUPFAILURE
0x1001
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
CFERR_MAXLESSTHANMIN
0x2002
La dimensione specificata nel membro nSizeMax della struttura CHOOSEFONT è minore della dimensione specificata nel membro nSizeMin .
CFERR_NOFONTS
0x2001
Nessun carattere esistente.
 

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

Codice/valore restituito Descrizione
FNERR_BUFFERTOOSMALL
0x3003
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.
FNERR_INVALIDFILENAME
0x3002
Nome file non valido.
FNERR_SUBCLASSFAILURE
0x3001
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
FRERR_BUFFERLENGTHZERO
0x4001
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

CHOOSECOLOR

CHOOSEFONT

ChooseColor

ScegliFont

Libreria delle finestre di dialogo comuni

Informazioni concettuali

DEVNAMES

DialogBox

FINDREPLACE

Findtext

Getopenfilename

GetSaveFileName

OPENFILENAME

PAGESETUPDLG

PRINTDLG

PageSetupDlg

PrintDlg

Riferimento

RegisterWindowMessage

ReplaceText