HRESULT WINAPI AtlReportError (const CLSIDamp; CLSID, LPCOLESTR lpszDescconst IID & IID = GUID_NULL, HRESULT HRESULT = 0 );
HRESULT WINAPI AtlReportError (const CLSIDamp; CLSID, LPCOLESTR lpszDescDWORDdwHelpIDLPCOLESTRlpszHelpFileconst IID & IID = GUID_NULL, HRESULT HRESULT = 0 );
HRESULT WINAPI AtlReportError (const CLSIDamp; CLSID, LPCSTR lpszDesc, const IID & IID = GUID_NULL, HRESULT HRESULT = 0 );
HRESULT WINAPI AtlReportError (const CLSIDamp; CLSID, LPCSTR lpszDescDWORDdwHelpIDLPCSTRlpszHelpFileconst IID & IID = GUID_NULL, HRESULT HRESULT = 0 );
HRESULT WINAPI AtlReportError (const CLSIDamp; CLSID, UINT nID, const IID & IID = GUID_NULL, HRESULT HRESULT = 0, HINSTANCEhInst= _Module.GetResourceInstance ());
HRESULT WINAPI AtlReportError (const CLSIDamp; CLSID, UINT nIDDWORDdwHelpIDLPCOLESTRlpszHelpFileconst IID & IID = GUID_NULL, HRESULT HRESULT = 0, HINSTANCEhInst= _Module.GetResourceInstance ());
Valore restituito
Se il parametro HRESULT è diverso da zero, restituisce il valore di HRESULT. Se HRESULT è zero, le prime quattro versioni di AtlReportError restituiscono DISP_E_EXCEPTION. Le ultime due versioni restituiscono il risultato della macro MAKE_HRESULT (1, FACILITY_ITF, nID ).
Parametri
clsid
[in] Il CLSID dell'oggetto segnalato l'errore.
lpszDesc
[in] Stringa che descrive l'errore. La versione Unicode specifica che lpszDesc è di tipo LPCOLESTR; la versione ANSI specifica un tipo di LPCSTR.
iid
[in] L'IID dell'interfaccia definisce l'errore o GUID_NULL se l'errore è definito dal sistema operativo.
hRESULT
[in] L' HRESULT volete restituita al chiamante.
nID
[in] L'identificatore di risorsa cui è memorizzata la stringa di descrizione errore. Questo valore dovrebbe essere compresa tra 0x0200 e 0xFFFF, inclusiva. Nelle build di debug un' asserzione determinerà se nID non indicizza una stringa valida. Nelle build di rilascio, la stringa di descrizione errore sarà impostata su "Errore sconosciuto".
dwHelpID
[in] L'identificatore di contesto di aiuto per l'errore.
lpszHelpFile
[in] Il percorso e il nome del file della guida che descrive l'errore.
hInst
[in] L'handle alla risorsa. Per impostazione predefinita, questo parametro è _Module::GetResourceInstance, dove Module è l'istanza globale di CComModule o una classe derivata da essa.
Osservazioni
Imposta la interfaccia IErrorInfo per fornire informazioni sull'errore ai clienti dell'oggetto. La stringa lpszDesc è usato come la descrizione dell'errore. Quando il client riceve l' HRESULT che restituire da AtlReportError, il client può accedere la struttura IErrorInfo per informazioni dettagliate sull'errore.
Vedi anche