共用方式為

CComCoClass::Error

  • 發行項

這個靜態函式設定 IErrorInfo 介面提供錯誤資訊給用戶端。

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

參數

  • lpszDesc
    [out] 描述錯誤的字串。 Error Unicode 版本指定 lpszDesc 是型別 LPCOLESTR; LPCSTRANSI 版本所指定的型別。

  • iid
    [in] 定義錯誤或 GUID_NULL (預設值) 之介面的 IID，如果錯誤是由作業系統所定義。

  • hRes
    [in] 要傳回至呼叫端的 HRESULT 。 預設值為 0。 如需的詳細資訊，請參閱 hRes備註。

  • nID
    [out] 用來儲存錯誤描述字串的資源識別項。 這個值必須介於和之間 0x0200 0xFFFF，則包含。 nID 索引，如果沒有有效的字串，在偵錯組建中， ASSERT 仍然會發生。 在發行的組建中，錯誤描述字串會設為「未知的錯誤」。

  • dwHelpID
    [in] 錯誤的說明主題代碼。

  • lpszHelpFile
    [in] 說明檔案的路徑和名稱描述錯誤。

  • hInst
    [out] 資源控制代碼。 根據預設，這個參數是 _AtlModule::GetResourceInstance， _AtlModule 是 CAtlModule全域執行個體。

傳回值

標準 HRESULT 值。 如需詳細資訊，請參閱"備註"。

備註

若要呼叫 Error，您的物件必須實作介面 ISupportErrorInfo Interface 。

如果 hRes 參數不為零，則 ErrorhRes傳回的值。 如果 hRes 為零，則 Error 傳回 DISP_E_EXCEPTION前四個版本。 前兩個版本傳回巨集 MAKE_HRESULT( 1, FACILITY_ITF, nID **)**的結果。

需求

Header: atlcom.h

請參閱

參考

CComCoClass 類別

ISupportErrorInfoImpl 類別

MAKE_HRESULT