PerfQueryCounterSetRegistrationInfo 関数 (perflib.h)

  • [アーティクル]

指定したシステムのカウンター セットに関する情報を取得します。

構文

ULONG PerfQueryCounterSetRegistrationInfo(
  [in, optional]  LPCWSTR         szMachine,
  [in]            LPCGUID         pCounterSetId,
                  PerfRegInfoType requestCode,
                  DWORD           requestLangId,
  [out, optional] LPBYTE          pbRegInfo,
                  DWORD           cbRegInfo,
  [out]           LPDWORD         pcbRegInfoActual
);

パラメーター

[in, optional] szMachine

pCounterSet パラメーターが指定するカウンター セットに関する情報を取得するコンピューターの名前。 NULL の場合、関数はローカル コンピューターの指定したカウンター セットに関する情報を取得します。

[in] pCounterSetId

情報を取得するカウンター セットのカウンター セット識別子。

requestCode

カウンター セットについて取得する情報の種類。 使用可能な値の一覧については、「 PerfRegInfoType 」を参照してください。

requestLangId

requestCode がPERF_REG_COUNTERSET_NAME_STRINGの場合、要求された情報を含む文字列の優先ロケール識別子。

PERF_REG_COUNTERSET_HELP_STRING、 PERF_REG_COUNTER_NAME_STRINGS、または

PERF_REG_COUNTER_HELP_STRINGS。

requestCode がPERF_REG_COUNTER_STRUCTされている場合、データが必要なカウンターのカウンター識別子。

requestCode の他のすべての値については、0 に設定します。

[out, optional] pbRegInfo

cbRegInfo パラメーターが指定するデータ量をバイト単位で受け取るのに十分な大きさのバッファーへのポインター。 たぶん

cbRegInfo が 0 の場合は NULL。

cbRegInfo

pbRegInfo パラメーターが指定するバッファーのサイズ (バイト単位)。

[out] pcbRegInfoActual

カウンター セットに関する情報を取得するために実際に必要なバッファーのサイズ。 意味は、関数の値によって異なります

返します。

関数の戻り値 pcbRegInfoActual の意味
ERROR_SUCCESS の数

pbRegInfo が指定したバッファーに関数が格納した、指定したカウンター セットに関する情報のバイト数。
ERROR_NOT_ENOUGH_MEMORY 次に、

指定したマシンに設定されたカウンターに関する情報を格納するために必要なバッファーのサイズ (バイト単位)。 バッファーを必要に応じて拡大します。

size し、関数をもう一度呼び出します。
その他 値は未定義であり、使用しないでください。

戻り値

リターン コード 説明
ERROR_SUCCESS
 関数は、 pbRegInfo が指定したバッファーに、カウンター セットに関するすべての情報を正常に格納しました。 pcbRegInfoActual が指す値は、バッファーに実際に格納されている情報の量をバイト単位で示します。
ERROR_NOT_ENOUGH_MEMORY
 pbRegInfo が指定したバッファーは、カウンター セットに関するすべての情報を格納するのに十分な大きさではありません。 pcbRegInfoActual が指す値は、すべての情報を格納するために必要なバッファーのサイズを示します。 バッファーを必要に応じて拡大します。

size し、関数をもう一度呼び出します。
 

その他の種類のエラーの場合、戻り値は システム エラー コードです。

解説

要求できるデータの種類については、「 PerfRegInfoType 」を参照してください。

要求の種類ごとに提供されるデータの形式。

要件

   
サポートされている最小のクライアント Windows 10バージョン 1607 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2016 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー perflib.h
Library AdvAPI32.lib
[DLL] AdvAPI32.dll