Skip to content

Latest commit

 

History

History
77 lines (61 loc) · 2.59 KB

nf-winevt-evtgetextendedstatus.md

File metadata and controls

77 lines (61 loc) · 2.59 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:winevt.EvtGetExtendedStatus
EvtGetExtendedStatus function (winevt.h)
Gets a text message that contains the extended error information for the current error.
EvtGetExtendedStatus
EvtGetExtendedStatus function [EventLog]
wes.evtgetextendedstatus
winevt/EvtGetExtendedStatus
wes\evtgetextendedstatus.htm
wes
49451981-b3de-4515-ae88-835f17a0a8f9
12/05/2018
EvtGetExtendedStatus, EvtGetExtendedStatus function [EventLog], wes.evtgetextendedstatus, winevt/EvtGetExtendedStatus
winevt.h
Windows
Windows Vista [desktop apps only]
Windows Server 2008 [desktop apps only]
Wevtapi.lib
Wevtapi.dll
Windows
19H1
EvtGetExtendedStatus
winevt/EvtGetExtendedStatus
c++
APIRef
kbSyntax
DllExport
Wevtapi.dll
EvtGetExtendedStatus

EvtGetExtendedStatus function

-description

Gets a text message that contains the extended error information for the current error.

-parameters

-param BufferSize [in]

The size of the Buffer buffer, in characters.

-param Buffer [in]

A caller-allocated string buffer that will receive the extended error information. You can set this parameter to NULL to determine the required buffer size.

-param BufferUsed [out]

The size, in characters, of the caller-allocated buffer that the function used or the required buffer size if the function fails with ERROR_INSUFFICIENT_BUFFER.

-returns

The return value is ERROR_SUCCESS if the call succeeded; otherwise, a Win32 error code.

-remarks

You must call this function on the thread that generated the error and before calling another Windows Event Log function.

The EvtQuery and EvtSubscribe functions can provide extended error information if there is a problem with the specified XPath. For example, the error information can identify the character in the XPath where a parsing error occurred. To receive the extended error information for a malformed XPath, you cannot specify the EvtQueryTolerateQueryErrors flag when calling EvtQuery or EvtSubscribe.