TdhLoadManifest function

Loads the manifest used to decode a log file.

Syntax


ULONG WINAPI TdhLoadManifest(
  _In_  PWSTR Manifest
);

Parameters

Manifest [in]

The full path to the manifest.

Return value

Returns ERROR_SUCCESS if successful. Otherwise, this function returns one of the following return codes in addition to others.

Return codeDescription
ERROR_FILE_NOT_FOUND

The manifest file was not found at the specified path.

ERROR_INVALID_PARAMETER

The Manifest parameter cannot be NULL and the path cannot exceed MAX_PATH.

ERROR_XML_PARSE_ERROR

The manifest did not pass validation. To determine the validation errors, run the manifest through the message compiler (mc.exe).

 

Remarks

To consume events, TDH requires the provider's manifest. Typically, you decode the log file on a computer that contains the provider. Since the provider includes the mainifest as a resource, TDH uses the provider to get the manifest. To decode the log file on a computer that does not contain the provider, you must first use the TraceRpt.exe executable to export the manifest (see the –export switch) from the provider on a computer that does contain the provider. After you have the manifest file, you can decode the log file on a computer that does not contain the provider.

You need to call this function before decoding the first event. For example, you can call this function before calling the OpenTrace function. After processing all the events, call the TdhUnloadManifest function.

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Tdh.h

Library

Tdh.lib

DLL

Tdh.dll

See also

TdhUnloadManifest

 

 

Community Additions

ADD
Show:
© 2014 Microsoft