PdhVbAddCounter 関数

PdhVbAddCounter 関数は、指定したクエリオブジェクトにカウンターエントリを作成し、正常に完了すると、そのカウンターへのハンドルを返します。

重要

このトピックで説明する関数は、今後変更されたり使用できなくなったりする可能性があります。代わりに、「パフォーマンスカウンター関数」で説明されている関数を使用することをお勧めします。

関数 PdhVbAddCounter( _ ByVal QueryHandle As Long, _ ByVal CounterPath As String, _ ByVal CounterHandle As Long _ ) As Long

パラメーター

QueryHandle: このカウンターが割り当てられるクエリの ID。この値は PdhVbOpenQuery 関数によって返されます。
CounterPath: クエリに追加するカウンターパスの名前を指定するテキスト文字列。この文字列の内容は、カウンターブラウザーまたはその他のソースから取得した有効なカウンターパスである必要があります。
CounterHandle: クエリでこのカウンターを識別する一意の参照。この変数は、関数が呼び出される前に 0 に初期化する必要があります。関数が正常に完了した場合にのみ、戻り値に有効な値が含まれます。

関数が成功した場合は、ERROR_SUCCESSと等しい 長整数 と CounterHandle 変数の新しいハンドルを返します。

関数が失敗した場合、戻り値はシステムエラーコードまたは PDH エラーコードです。使用できる値を次に示します。

リターンコード	説明
PDH_INVALID_ARGUMENT	1 つ以上の引数が無効または正しくありません。
PDH_MEMORY_ALLOCATION_FAILURE	メモリバッファーを割り当てませんでした。
PDH_INVALID_HANDLE	クエリハンドルが無効です。
PDH_CSTATUS_NO_COUNTER	指定されたカウンターが見つかりませんでした。
PDH_CSTATUS_NO_OBJECT	指定したオブジェクトが見つかりませんでした。
PDH_CSTATUS_NO_MACHINE	コンピューターエントリを作成できませんでした。
PDH_CSTATUS_BAD_COUNTERNAME	空のカウンター名パス文字列が渡されました。
PDH_FUNCTION_NOT_FOUND	このカウンターの計算関数を決定できませんでした。