TdhGetEventMapInformation 函式 (tdh.h)

  • 發行項

擷取事件中包含的事件對應相關信息。

語法

TDHSTATUS TdhGetEventMapInformation(
  [in]      PEVENT_RECORD   pEvent,
  [in]      PWSTR           pMapName,
  [out]     PEVENT_MAP_INFO pBuffer,
  [in, out] ULONG           *pBufferSize
);

參數

[in] pEvent

傳遞至 EventRecordCallback 回 呼的事件記錄。 如需詳細資訊，請參閱 EVENT_RECORD 結構。

[in] pMapName

Null 終止的 Unicode 字串，其中包含對應屬性值的名稱。 此名稱來自 EVENT_PROPERTY_INFO 結構的 MapNameOffset 成員。

[out] pBuffer

使用者配置緩衝區以接收事件對應。 地圖可以是值地圖、點陣圖或圖樣圖。 如需詳細資訊，請參閱 EVENT_MAP_INFO 結構。

[in, out] pBufferSize

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

傳回值

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

傳回碼 Description
ERROR_INSUFFICIENT_BUFFER
 pBuffer 緩衝區的大小太小。 使用 pBufferSize 中設定的必要緩衝區大小來配置新的緩衝區。
ERROR_NOT_FOUND
 找不到事件的架構，或找不到指定的對應。
ERROR_FILE_NOT_FOUND
 指令清單中的 resourceFileName 屬性包含提供者二進位檔的位置。 當您註冊指令清單時，位置會寫入登錄。 TDH 無法根據已註冊的位置找到二進位檔。
ERROR_INVALID_PARAMETER
 一或多個參數無效。
ERROR_WMI_SERVER_UNAVAILABLE
 WMI 服務無法使用。

備註

您無法使用此函式來擷取 WPP 事件的事件對應資訊。

針對指令清單中定義的對應，字串會在字串結尾包含空格。 例如，如果值對應至指令清單中的 「Monday」，則會將字串傳回為 「Monday 」 。

範例

如需示範如何呼叫此函式的範例，請參閱 使用 TdhGetProperty 取用事件數據。

規格需求

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