<Return[PQ]><Top>

PdhExpandCounterPath

Declare Sub Api_PdhExpandCounterPath Lib "pdh" Alias "PdhExpandCounterPath" (ByVal szWildCardPath$, ByVal mszExpandedPathList$, ByRef pcchPathListLength&)

Declare Sub PdhExpandCounterPath Lib "pdh" (ByVal szWildCardPath As String, ByVal mszExpandedPathList As String, ByRef pcchPathListLength As Long)

指定したカウンタパスのワイルドカード文字列と一致する、指定したコンピュータ(何も指定しない場合はローカルコンピュータ)のカウンタとカウンタインスタンスのリストを取得する。

パラメータ
szWildCardPath
    カウンタパスを指定する。
mszExpandedPathList
    szWildCardPath パラメータが指すバッファのワイルドカード指定と一致するカウンタパス名のリストを受け取るバッファへのポインタを指定す

    る。このバッファは呼び出し側が確保する。
pcchPathListLength
    mszExpandedPathList パラメータが指すバッファのサイズを文字数で指定する。関数から制御が戻るときは、取得したパス文字列によって

    実際に使われているサイズを受け取る。
    mszExpandedPathList パラメータが指すバッファが小さすぎて、リスト全体が収まらない場合は、戻り値が PDH_MORE_DATA になる。

    その場合は pcchPathListLength パラメータが指す変数が、取得したパス文字列を格納するのに必要なサイズに設定される。

戻り値
    関数が成功すると、PDH_CSTATUS_VALID_DATA が返る。
    関数が失敗すると、PDHMSG.H ヘッダーファイルで定義されている PDH エラーステータスの 1 つが返る。