TdhLoadManifest 函式 (tdh.h)

  • 發行項

載入用來譯碼記錄檔的指令清單。

語法

TDHSTATUS TdhLoadManifest(
  [in] PWSTR Manifest
);

參數

[in] Manifest

指令清單的完整路徑。

傳回值

如果成功，則傳回ERROR_SUCCESS。 否則，此函式除了傳回其他傳回碼之外，還會傳回下列其中一個傳回碼。

傳回碼 Description
ERROR_FILE_NOT_FOUND
 在指定的路徑找不到指令清單檔。
ERROR_INVALID_PARAMETER
 Manifest 參數不能是 NULL，而且路徑不能超過MAX_PATH。
ERROR_XML_PARSE_ERROR
 指令清單未通過驗證。 若要判斷驗證錯誤，請透過訊息編譯程式執行指令清單 (mc.exe) 。

備註

若要取用事件，TDH 需要提供者的指令清單。 一般而言，您會將包含提供者的計算機上記錄檔譯碼。 由於提供者包含指令清單作為資源，因此 TDH 會使用提供者來取得指令清單。 若要將不包含提供者的計算機上記錄檔譯碼，您必須先使用 TraceRpt.exe 可執行檔匯出指令清單， (查看包含提供者之計算機上的 –export 參數) 。 擁有指令清單檔案之後，您可以在不包含提供者的計算機上譯碼記錄檔。

在譯碼第一個事件之前，您必須呼叫此函式。 例如，您可以在呼叫 OpenTrace 函式之前呼叫此函式。 處理所有事件之後，請呼叫 TdhUnloadManifest 函式。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 tdh.h
程式庫 Tdh.lib
Dll Tdh.dll

另請參閱

TdhUnloadManifest