CComCoClass::Error

Articolo
03/05/2013

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

Classe di CComCoClass

Classe di ISupportErrorInfoImpl

MAKE_HRESULT

Condividi tramite