PerfEnumerateCounterSet 関数 (perflib.h)

  • [アーティクル]

に登録されているカウンター セットのカウンター セット識別子を取得します。

指定されたシステム。

カウンター セット識別子は、グローバル一意識別子 (GUID) です。

構文

ULONG PerfEnumerateCounterSet(
  [in, optional]  LPCWSTR szMachine,
  [out, optional] LPGUID  pCounterSetIds,
                  DWORD   cCounterSetIds,
  [out]           LPDWORD pcCounterSetIdsActual
);

パラメーター

[in, optional] szMachine

カウンター セット識別子を取得するコンピューターの名前。 NULL の場合、関数はローカル コンピューターのカウンター セット識別子を取得します。

[out, optional] pCounterSetIds

cCounterSetIds パラメーターが指定する GUID の数を受け取るのに十分な領域を持つバッファーへのポインター。 場合は NULL になる可能性があります

cCounterSetIds は 0 です。

cCounterSetIds

pCounterSetIds パラメーターが指定するバッファーのサイズを GUID で測定します。

[out] pcCounterSetIdsActual

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

返します。

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

pCounterSetIds が指定したバッファーに関数が格納されている GUID。
ERROR_NOT_ENOUGH_MEMORY 次に、

必要なバッファーのサイズ (GUID 単位)。 バッファーを必要なサイズに拡大する

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

戻り値

リターン コード 説明
ERROR_SUCCESS
 関数は、 pCounterSetIds が指定したすべてのコンテンツ セット識別子をバッファーに正常に格納しました。 pcCounterSetIdsActual が指す値は、バッファーに実際に格納されているカウンター セット識別子の数を示します。
ERROR_NOT_ENOUGH_MEMORY
 pCounterSetIds が指定したバッファーが、指定されたシステムのカウンター セットのすべてのカウンター セット識別子を格納するのに十分な大きさではなかった。 pcCounterSetIdsActual が指す値は、すべてのカウンター セット識別子を格納するために必要なバッファーのサイズを示します。 バッファーを必要なサイズに拡大する

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

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

要件

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

こちらもご覧ください

PerfEnumerateCounterSetInstances