Método IDataModelManager2::CreateErrorObject (dbgmodel.h)

O método CreateErrorObject cria um "objeto error". O modelo de dados não tem a noção de exceções e fluxo de exceção. A falha sai de uma propriedade/método de duas maneiras:

• Um único HRESULT com falha sem informações de erro estendidas. Não há mais informações que possam ser fornecidas para o erro ou o erro em si é autoexplicativo do HRESULT retornado.

• Um único HRESULT com falha, juntamente com informações de erro estendidas. As informações de erro estendidas são um objeto de erro retornado no argumento de saída da propriedade/método .

Sintaxe

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

Parâmetros

hrError

O código de erro para o qual as informações de erro estendidas estão sendo criadas. Se uma determinada função for a entidade que cria um objeto de erro para uma falha, esse código deverá corresponder ao HRESULT com falha retornado pela função.

pwszMessage

Uma mensagem opcional que dá uma indicação mais profunda do que falhou e por quê. Essa mensagem será a conversão de cadeia de caracteres de exibição do objeto de erro criado.

object

O objeto de erro recém-construído/em caixa será retornado aqui.

Retornar valor

Esse método retorna HRESULT.

Comentários

Código de exemplo

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.
}

Requisitos

Confira também

Interface IDataModelManager2