CComCoClass::Error

Článek
03/04/2013

Statická funkce nastaví IErrorInfo rozhraní klientovi poskytnout informace o chybě.

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() 
);

Parametry

lpszDesc
[v] Řetězec popisující chybu.Verzi Unicode Error Určuje, že lpszDesc je typu LPCOLESTR; Určuje typ verze ANSI LPCSTR .
iid
[v] IID rozhraní definující chybu nebo GUID_NULL (výchozí hodnota) Pokud je definován chyby operačního systému.
hRes
[v] HRESULT Chcete vrátit volajícímu.Výchozí hodnota je 0.Další podrobnosti o hRes , naleznete v části poznámky.
nID
[v] Identifikátor prostředku, kde je uložen řetězec popisu chyby.Tato hodnota by měla ležet mezi 0x0200 a 0xFFFF, včetně.V sestavení ladění ASSERT dojde-li nID index není platný řetězec.Ve verzi sestavení řetězec popisu chyby bude nastaven na "Neznámá chyba.
dwHelpID
[v] Identifikátor nápovědy kontext chyba.
lpszHelpFile
[v] Cesta a název souboru nápovědy popisující chybu.
hInst
[v] Popisovač prostředku.Ve výchozím nastavení je tento parametr _AtlModule::GetResourceInstance, kde _AtlModule je globální instance CAtlModule.

Vrácená hodnota

Standard HRESULT hodnotu.Podrobnosti naleznete v části poznámky.

Poznámky

Volání Error , objekt musí implementovat ISupportErrorInfo Interface rozhraní.

Pokud hRes parametr je nenulová, pak Error vrátí hodnotu hRes .Pokud hRes nula, je první čtyři verze Error vrátit DISP_E_EXCEPTION .Poslední dvě verze vrací výsledek makro MAKE_HRESULT (1, FACILITY_ITF, nID ).

Požadavky

Záhlaví: atlcom.h

Viz také

Referenční dokumentace

Třída CComCoClass

Třída ISupportErrorInfoImpl

MAKE_HRESULT

Sdílet prostřednictvím