Método IDataModelManager4::CreateErrorObject (dbgmodel.h)
O método CreateErrorObject cria um "objeto de erro". 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 HRESULT com falha única 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 HRESULT com falha única, 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.
Valor de retorno
Esse método retorna HRESULT.
Observações
de código de exemplo
ComPtr<IDataModelManager4> 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 |