PdhVbGetCounterPathElements 関数

PdhVbGetCounterPathElements 関数は、完全修飾パフォーマンス カウンター パス文字列を個々の要素に解析します。 この関数で使用する前に、各文字列変数は同じサイズ (BufferSize) であり、ディメンション化および初期化されている必要があります。

重要

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

関数 PdhVbGetCounterPathElements( _ ByVal PathString As String, _ ByVal MachineName As String, _ ByVal ObjectName As String, _ ByVal InstanceName As String, _ ByVal ParentInstance As String, _ ByVal CounterName As String, _ ByVal BufferSize As Long _ ) As Long

パラメーター

PathString

個々の要素に分割されるカウンター パス文字列。

MachineName

コンピューター名を受け取る文字列。

ObjectName

オブジェクト名を受け取る文字列。

InstanceName

インスタンス名を受け取る文字列 (使用されている場合)。

ParentInstance

親インスタンスを受け取る文字列 (使用されている場合)。

CounterName

カウンター名を受け取る文字列。

BufferSize

この関数呼び出しのパラメーターとして使用される各文字列変数の最大サイズ。

戻り値

関数が成功した場合は、ERROR_SUCCESSと等しい 長整数 を返します。

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

リターン コード	説明
PDH_INVALID_ARGUMENT	1 つ以上の文字列バッファーが正しいサイズではありません。
PDH_MORE_DATA	1 つ以上のカウンター パス要素が、戻りバッファーの長さに対して大きすぎます。
PDH_MEMORY_ALLOCATION_FAILURE	一時メモリ バッファーを割り当てませんでした。

要件

要件	値
サポートされている最小のクライアント	Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップ アプリのみ]
ライブラリ	Pdh.lib
[DLL]	Pdh.dll

こちらもご覧ください

PdhVbCreateCounterPathList

PdhVbGetCounterPathFromList

PdhVbGetOneCounterPath