Edit

TdhGetManifestEventInformation function (tdh.h)

  • Article

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
ERROR_EMPTY
 There are no events defined for the provider GUID in the manifest.
ERROR_FILE_NOT_FOUND
 The metadata for the provider was not found.
ERROR_INSUFFICIENT_BUFFER
 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.
ERROR_INVALID_PARAMETER
 One or more of the parameters is not valid.
ERROR_NOT_FOUND
 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

See also

EVENT_DESCRIPTOR

PROVIDER_EVENT_INFO

TRACE_EVENT_INFO

TdhEnumerateManifestProviderEvents