PdhMakeCounterPath カウンタパス名の作成

Cの宣言:

PDH_STATUS PdhMakeCounterPath(
	IN PDH_COUNTER_PATH_ELEMENTS Elements,
	IN LPTSTR CounterPath,
	IN LPDWROD CounterPathSize,
	IN DWORD Flags);

説明:

Elementsで指定した、カウンタパスの構成要素を元に、カウンタの降るパス名を作成し、結果をCounterPathに返す。

引数の意味は以下の通り。
Elements (IN) 作成元のカウンタパスの構成要素
CounterPath (OUT) 作成結果のカウンタパス名を表す文字列。
CounterPathSize (IN/OUT) CounterPathのサイズ。関数の実行後、CounterPathに設定されたデータのサイズまたは必要なサイズが返される。
Flags (IN) 0でなければならない。

Cのサンプル:

PdhMakeCounterPathによって、メモ帳のCPU使用率を表すパフォーマンスカウンタのパス名を構成する。
void TestMakingCounterPath()
{
	PDH_COUNTER_PATH_ELEMENTS cpe;
	char Path[1000];
	DWORD Size = 1000;

	cpe.szMachineName = NULL;
	cpe.szObjectName = "Process";
	cpe.szInstanceName = "notepad";
	cpe.szParentInstance = NULL;
	cpe.dwInstanceIndex = 0;
	cpe.szCounterName = "% Processor Time";

	PdhMakeCounterPath(&cpe, Path, &Size, 0);

	printf("メモ帳のCPU使用率のカウンタのパス: %s\n", Path);
}


(original text:1999/01/12 更新)

本ドキュメントの内容は保証しません。本ドキュメントによって生じた結果について、一切の責任を負いません。