Função GetErrorInfo (oleauto.h)

  • Artigo

Obtém o ponteiro de informações de erro definido pela chamada anterior para SetErrorInfo no thread lógico atual.

Sintaxe

HRESULT GetErrorInfo(
  [in]  ULONG      dwReserved,
  [out] IErrorInfo **pperrinfo
);

Parâmetros

[in] dwReserved

Reservado para uso futuro. Deve ser zero.

[out] pperrinfo

Um objeto de erro.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
 Êxito.
S_FALSE
 Não houve nenhum objeto de erro a ser retornado.

Comentários

Essa função retorna um ponteiro para o ponteiro IErrorInfo definido mais recentemente no thread lógico atual. Ele transfere a propriedade do objeto de erro para o chamador e limpa o estado de erro do thread.

Fazer uma chamada COM que passa por um proxy-stub limpará qualquer objeto de erro existente para o thread de chamada. Um objeto chamado não deve fazer essas chamadas depois de chamar SetErrorInfo e antes de retornar. O chamador não deve fazer essas chamadas depois que a chamada retornar e antes de chamar GetErrorInfo. Como regra geral, um método de interface deve retornar o mais rápido possível depois de chamar SetErrorInfo, e o chamador deve chamar GetErrorInfo o mais rápido possível após o retorno da chamada.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho oleauto.h
Biblioteca OleAut32.lib
DLL OleAut32.dll