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を返し、このパラメーターを必要なバッファー サイズに設定します。 入力時にバッファー サイズが 0 の場合、バッファーにデータは返されません。このパラメーターは必要なバッファー サイズを受け取ります。

戻り値

成功した場合は、ERROR_SUCCESSを返します。 それ以外の場合、この関数は、他の戻りコードに加えて、次のいずれかのリターン コードを返します。

注釈

この関数を使用して、WPP イベントのイベント マップ情報を取得することはできません。

マニフェストで定義されているマップの場合、文字列には文字列の末尾にスペースが含まれます。 たとえば、値がマニフェストの "Monday" にマップされている場合、文字列は "Monday" として返されます。

例

この関数を呼び出す方法を示す例については、「 TdhGetProperty を使用してイベント データを使用する」を参照してください。

要件