TdhGetManifestEventInformation 函式 (tdh.h)

  • 發行項

TdhGetManifestEventInformation 函式會擷取指令清單中事件的相關元數據。

語法

TDHSTATUS TdhGetManifestEventInformation(
  [in]      LPGUID            ProviderGuid,
  [in]      PEVENT_DESCRIPTOR EventDescriptor,
  [out]     PTRACE_EVENT_INFO Buffer,
  [in, out] ULONG             *BufferSize
);

參數

[in] ProviderGuid

GUID，識別您想要擷取其事件元數據的指令清單提供者。

[in] EventDescriptor

事件描述元的指標，其中包含事件標識碼、版本、op-code 和關鍵詞等資訊。 如需詳細資訊，請參閱 EVENT_DESCRIPTOR 結構

[out] Buffer

使用者配置的緩衝區，可接收提供者指令清單中事件的相關元數據。 如需詳細資訊，請參閱 TRACE_EVENT_INFO 結構。

[in, out] BufferSize

Buffer 參數所指向之緩衝區的大小，以位元組為單位。 如果函式成功，此參數會接收所使用的緩衝區大小。 如果緩衝區太小，函式會 傳回ERROR_INSUFFICIENT_BUFFER ，並將此參數設定為所需的緩衝區大小。 如果輸入上的緩衝區大小為零，則緩衝區中不會傳回任何數據，而且此參數會收到所需的緩衝區大小。

傳回值

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

傳回碼 Description
ERROR_EMPTY
 指令清單中沒有為提供者 GUID 定義的事件。
ERROR_FILE_NOT_FOUND
 找不到提供者的元數據。
ERROR_INSUFFICIENT_BUFFER
 Buffer 參數所指向的緩衝區大小太小。 使用 BufferSize 參數中設定的必要緩衝區大小來配置新的緩衝區。
ERROR_INVALID_PARAMETER
 一或多個參數無效。
ERROR_NOT_FOUND
 找不到所提供提供者 GUID 的架構資訊。

規格需求

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

另請參閱

EVENT_DESCRIPTOR

PROVIDER_EVENT_INFO

TRACE_EVENT_INFO

TdhEnumerateManifestProviderEvents