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

Требования

См. также

интерфейс IDataModelManager2