IDataModelManager::CreateErrorObject 方法 (dbgmodel.h)
CreateErrorObject 方法會建立「錯誤物件」。 數據模型沒有例外狀況和例外狀況流程的概念。 失敗有兩種方式來自屬性/方法:
沒有擴充錯誤資訊的單一失敗 HRESULT。 沒有任何可針對錯誤提供的詳細資訊,或錯誤本身是傳回的 HRESULT 自我說明。
單一失敗的 HRESULT 與擴充錯誤信息結合。 擴充錯誤資訊是在 屬性/方法的 output 自變數中傳回的錯誤物件。
語法
HRESULT CreateErrorObject(
HRESULT hrError,
PCWSTR pwszMessage,
IModelObject **object
);
參數
hrError
要為其建立擴充錯誤信息的錯誤碼。 如果指定的函式是建立失敗錯誤對象的實體,此程式代碼必須符合函式傳回的失敗 HRESULT。
pwszMessage
選擇性訊息,提供失敗原因和原因的更深入指示。 此訊息將會是所建立錯誤對象的顯示字串轉換。
object
這裡會傳回新建構/Boxed 錯誤物件。
傳回值
這個方法會傳回 HRESULT。
備註
範例程式碼
ComPtr<IDataModelManager> spManager; /* get the data model manager */
ComPtr<IModelObject> spError;
if (SUCCEEDED(spManager->CreateErrorObject(
E_INVALIDARG,
L"Calls to the Sum() method must pass at least one argument",
&spError)))
{
// You can pass this back in places where you see
// _COM_Errorptr_ annotated. Methods, for instance, may return
// E_INVALIDARG and an error object to channel out additional information.
// Property accessor GetValue implementations can also do this.
// Indexers can do this.
}
規格需求
需求 | 值 |
---|---|
標頭 | dbgmodel.h |