CreateErrorInfo

9/8/2008

Essa função cria uma instância de um genérico erro objeto.

Syntax

HRESULT CreateErrorInfo(
  ICreateErrorInfo** pperrinfo 
); 

Parameters

• pperrinfo
  [no] Ponteiro para um ponteiro para um genérico System-implemented objeto de erro que ofereça suporte a ICreateErrorInfo.

Return Value

Se bem-sucedido, a função retornará o valor HRESULT S_OK. Se ele não pôde criar o objeto de erro, a função retorna E_OUTOFMEMORY.

Remarks

Essa função recupera um ponteiro para um genérico erro objeto, que pode ser usada com Falha de QueryInterface Em ICreateErrorInfo para definir seu conteúdo. Em seguida, você pode transmitir o objeto resultante para SetErrorInfo.

O genérico erro objeto implementa dois ICreateErrorInfo e IErrorInfo.

Example

O seguinte exemplo codificar mostra como usar o CreateErrorInfo função.

Para usar essa função corretamente, verifique se você possui uma estrutura EXCEPINFO que é preenchida com informações sobre a exceção que ocorreu.

ICreateErrorInfo *perrinfo;
HRESULT hr;
hr = CreateErrorInfo(&pcerrinfo);
hr = pcerrinfo->SetGUID(IID_IHello);
hr = pcerrinfo->SetSource(m_excepinfo.bstrSource);
hr = pcerrinfo->SetDescription(m_excepinfo.bstrDescription);
hr = pcerrinfo->SetHelpFile(NULL);
hr = pcerrinfo->SetHelpContext(0);

hr = pcerrinfo->QueryInterface(IID_IErrorInfo, (LPVOID FAR*) &perrinfo);
if (SUCCEEDED(hr))
  {
    SetErrorInfo(0, perrinfo);
    perrinfo->Release();
  }
pcerrinfo->Release();

Passagem inválido (e, em algumas circunstâncias NULL) ponteiros para essa função faz com que uma terminação inesperada do aplicativo.

Requirements

See Also

Reference

Automation Functions
SetErrorInfo
DispInvoke