TdhGetManifestEventInformation function (tdh.h)
The TdhGetManifestEventInformation function retrieves metadata about an event in a manifest.
Syntax
TDHSTATUS TdhGetManifestEventInformation(
[in] LPGUID ProviderGuid,
[in] PEVENT_DESCRIPTOR EventDescriptor,
[out] PTRACE_EVENT_INFO Buffer,
[in, out] ULONG *BufferSize
);
Parameters
[in] ProviderGuid
A GUID that identifies the manifest provider whose event metadata you want to retrieve.
[in] EventDescriptor
A pointer to the event descriptor that contains information such as event id, version, op-code, and keyword. For details, see the EVENT_DESCRIPTOR structure
[out] Buffer
A user-allocated buffer to receive the metadata about an event in a provider manifest. For details, see the TRACE_EVENT_INFO structure.
[in, out] BufferSize
The size, in bytes, of the buffer pointed to by the Buffer parameter. If the function succeeds, this parameter receives the size of the buffer used. If the buffer is too small, the function returns ERROR_INSUFFICIENT_BUFFER and sets this parameter to the required buffer size. If the buffer size is zero on input, no data is returned in the buffer and this parameter receives the required buffer size.
Return value
Returns ERROR_SUCCESS if successful. Otherwise, this function returns one of the following return codes in addition to others.
Return code | Description |
---|---|
|
There are no events defined for the provider GUID in the manifest. |
|
The metadata for the provider was not found. |
|
The size of the buffer pointed to by the Buffer parameter is too small. Use the required buffer size set in the BufferSize parameter to allocate a new buffer. |
|
One or more of the parameters is not valid. |
|
The schema information for supplied provider GUID was not found. |
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 8.1 [desktop apps only] |
Minimum supported server | Windows Server 2012 R2 [desktop apps only] |
Target Platform | Windows |
Header | tdh.h |
Library | Tdh.lib |
DLL | Tdh.dll |