Метод IDataModelManager2::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.
}

Требования

Требование Значение
Заголовок dbgmodel.h

См. также раздел

Интерфейс IDataModelManager2