Export (0) Print
Expand All
Expand Minimize

TdhGetManifestEventInformation function

The TdhGetManifestEventInformation function retrieves metadata about an event in a manifest.

Syntax


ULONG TDHAPI TdhGetManifestEventInformation(
  _In_     LPGUID ProviderGuid,
  _In_     PEVENT_DESCRIPTOR EventDescriptor,
  _Out_    PTRACE_EVENT_INFO Buffer,
  _Inout_  ULONG *BufferSize
);

Parameters

ProviderGuid [in]

A GUID that identifies the manifest provider whose event metadata you want to retrieve.

EventDescriptor [in]

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

Buffer [out]

A user-allocated buffer to receive the metadata about an event in a provider manifest. For details, see the TRACE_EVENT_INFO structure.

BufferSize [in, out]

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 codeDescription
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

Minimum supported client

Windows 8.1 [desktop apps only]

Minimum supported server

Windows Server 2012 R2 [desktop apps only]

Header

Tdh.h

Library

Tdh.lib

DLL

Tdh.dll

See also

EVENT_DESCRIPTOR
PROVIDER_EVENT_INFO
TRACE_EVENT_INFO
TdhEnumerateManifestProviderEvents

 

 

Community Additions

ADD
Show:
© 2014 Microsoft