Função EvtGetExtendedStatus (winevt.h)

Obtém uma mensagem de texto que contém as informações de erro estendidas para o erro atual.

Sintaxe

DWORD EvtGetExtendedStatus(
  [in]  DWORD  BufferSize,
  [in]  LPWSTR Buffer,
  [out] PDWORD BufferUsed
);

Parâmetros

[in] BufferSize

O tamanho do buffer de buffer, em caracteres.

[in] Buffer

Um buffer de cadeia de caracteres alocado pelo chamador que receberá as informações de erro estendidas. Você pode definir esse parâmetro como NULL para determinar o tamanho do buffer necessário.

[out] BufferUsed

O tamanho, em caracteres, do buffer alocado pelo chamador que a função usou ou o tamanho do buffer necessário se a função falhar com ERROR_INSUFFICIENT_BUFFER.

Valor retornado

O valor retornado será ERROR_SUCCESS se a chamada for bem-sucedida; caso contrário, um código de erro Win32.

Comentários

Você deve chamar essa função no thread que gerou o erro e antes de chamar outra função do Log de Eventos do Windows.

As funções EvtQuery e EvtSubscribe poderão fornecer informações de erro estendidas se houver um problema com o XPath especificado. Por exemplo, as informações de erro podem identificar o caractere no XPath em que ocorreu um erro de análise. Para receber as informações de erro estendidas para um XPath malformado, não é possível especificar o sinalizador EvtQueryTolerateQueryErrors ao chamar EvtQuery ou EvtSubscribe.

Requisitos

Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winevt.h
Biblioteca	Wevtapi.lib
DLL	Wevtapi.dll