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
| Requisito | Valor |
|---|---|
| Cabeçalho | dbgmodel.h |