CComCoClass::Error

Articolo
06/09/2015

Questa funzione statica è installato l'interfaccia IErrorInfo per fornire informazioni al client.

static HRESULT WINAPI Error( 
   LPCOLESTR lpszDesc, 
   const IID& iid = GUID_NULL, 
   HRESULT hRes = 0  
); 
static HRESULT WINAPI Error( 
   LPCOLESTR lpszDesc, 
   DWORD dwHelpID, 
   LPCOLESTR lpszHelpFile, 
   const IID& iid = GUID_NULL, 
   HRESULT hRes = 0  
); 
static HRESULT WINAPI Error( 
   LPCSTR lpszDesc, 
   const IID& iid = GUID_NULL, 
   HRESULT hRes = 0  
); 
static HRESULT WINAPI Error( 
   LPCSTR lpszDesc, 
   DWORD dwHelpID, 
   LPCSTR lpszHelpFile, 
   const IID& iid = GUID_NULL, 
   HRESULT hRes = 0  
); 
static HRESULT WINAPI Error( 
   UINT nID, 
   const IID& iid = GUID_NULL, 
   HRESULT hRes = 0, 
   HINSTANCE hInst = _AtlBaseModule.GetResourceInstance () 
); 
static HRESULT Error( 
   UINT nID, 
   DWORD dwHelpID, 
   LPCOLESTR lpszHelpFile, 
   const IID& iid = GUID_NULL, 
   HRESULT hRes = 0, 
   HINSTANCE hInst = _AtlBaseModule.GetResourceInstance()  
);

Parametri

lpszDesc
[in] la stringa che descrive l'errore. La versione Unicode Error specifica che lpszDesc è di tipo LPCOLESTR; nella versione ANSI specifica un tipo LPCSTR.
iid
[in] l'iid dell'interfaccia che definisce l'errore o GUID_NULL (valore predefinito) se l'errore è definito dal sistema operativo.
hRes
[in] HRESULT che si desidera venga restituito al chiamante. Il valore predefinito è 0. Per ulteriori informazioni su hRes, vedere i commenti.
nID
[in] identificatore di risorsa in cui la stringa descrittiva di errori viene archiviata. Questo valore deve rientrare tra 0x0200 e 0xFFFF, nel suo complesso. Nelle build di debug, ASSERT un errore se nID non indicizza una stringa valida. Nelle build di rilascio, la stringa descrittiva di errori sarà "errore sconosciuto impostato."
dwHelpID
[in] identificatore di contesto della guida dell'errore.
lpszHelpFile
[in] il percorso e il nome del file della Guida che descrive l'errore.
hInst
[in] handle alla risorsa. Per impostazione predefinita, questo parametro è _AtlModule::GetResourceInstance, dove _AtlModule è l'istanza globale CAtlModule.

Valore restituito

Un valore standard HRESULT. Per informazioni dettagliate, vedere i commenti.

Note

Per chiamare Error, l'oggetto deve implementare l'interfaccia ISupportErrorInfo Interface.

Se il parametro hRes è diverso da zero, quindi Error restituisce il valore hRes. Se hRes è zero, le prime quattro versioni di ritorno DISP_E_EXCEPTIONdi Error. Le ultime due versioni restituisce il risultato di macro MAKE_HRESULT( 1, FACILITY_ITF, nID ).

Requisiti

Header: atlcom.h

Vedere anche

Riferimenti

CComCoClass Class

ISupportErrorInfoImpl Class

MAKE_HRESULT

Condividi tramite