IDataModelManager::CreateErrorObject 方法 (dbgmodel.h)

CreateErrorObject 方法创建一个“error 对象”。 数据模型没有异常和异常流的概念。 失败来自属性/方法的两种方式:

  • 没有扩展错误信息的单个失败 HRESULT。 要么没有可以为错误提供更多信息,要么错误本身从返回的 HRESULT 中一目了然。

  • 单个失败的 HRESULT 以及扩展的错误信息。 扩展的错误信息是在属性/方法的输出参数中返回的错误对象。

语法

HRESULT CreateErrorObject(
  HRESULT      hrError,
  PCWSTR       pwszMessage,
  IModelObject **object
);

参数

hrError

要为其创建扩展错误信息的错误代码。 如果给定函数是创建失败错误对象的实体,则此代码必须与函数返回的失败 HRESULT 匹配。

pwszMessage

可选消息,用于更深入地指示失败的原因。 此消息将是所创建错误对象的显示字符串转换。

object

将在此处返回新构造/装箱的错误对象。

返回值

此方法返回 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.
}

要求

要求
Header dbgmodel.h

另请参阅

IDataModelManager 接口