次の方法で共有

PdhValidatePathExA 関数 (pdh.h)

  • [アーティクル]

指定したカウンターがコンピューターまたはログ ファイルに存在することを検証します。

構文

PDH_FUNCTION PdhValidatePathExA(
  [in, optional] PDH_HLOG hDataSource,
  [in]           LPCSTR   szFullPathBuffer
);

パラメーター

[in, optional] hDataSource

データ ソースへのハンドル。 PdhOpenLog および pdhBindInputDataSource 関数 は、このハンドルを返します。

カウンターがローカル コンピューターに存在することを検証するには、NULL を指定します (これは PdhValidatePath呼び出すのと同じです)。

[in] szFullPathBuffer

検証するカウンター パスを指定する null-terminated 文字列を します。 カウンター パスの最大長は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 バージョンを自動的に選択するエイリアスとして PdhValidatePathEx を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

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

関連項目

PdhMakeCounterPath の

PdhValidatePath