次の方法で共有

PdhValidatePathA 関数 (pdh.h)

  • [アーティクル]

カウンター パスで指定されたコンピューターにカウンターが存在することを検証します。

構文

PDH_FUNCTION PdhValidatePathA(
  [in] LPCSTR szFullPathBuffer
);

パラメーター

[in] szFullPathBuffer

検証するカウンター パスを含む null で終わる文字列。 カウンター パスの最大長はPDH_MAX_COUNTER_PATH。

戻り値

関数が成功すると、ERROR_SUCCESSが返されます。

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

リターン コード 形容
PDH_CSTATUS_NO_INSTANCE
 指定されたパフォーマンス オブジェクトのインスタンスが見つかりませんでした。
PDH_CSTATUS_NO_COUNTER
 指定されたカウンターがパフォーマンス オブジェクトに見つかりませんでした。
PDH_CSTATUS_NO_OBJECT
 指定したパフォーマンス オブジェクトがコンピューター上に見つかりませんでした。
PDH_CSTATUS_NO_MACHINE
 指定したコンピューターが見つからないか、接続されていませんでした。
PDH_CSTATUS_BAD_COUNTERNAME
 カウンター パス文字列を解析できませんでした。
PDH_MEMORY_ALLOCATION_FAILURE
 関数は、必要な一時バッファーを割り当てることができません。

備考

手記

pdh.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして PdhValidatePath を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows XP [デスクトップ アプリのみ]
サポートされる最小サーバー Windows Server 2003 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー pdh.h
ライブラリ Pdh.lib
DLL Pdh.dll

関連項目

PdhMakeCounterPath の