PdhOpenQueryA 関数 (pdh.h)
パフォーマンス データのコレクションを管理するために使用される新しいクエリを作成します。
データ ソースにハンドルを使用するには、 PdhOpenQueryH 関数を使用します。
構文
PDH_FUNCTION PdhOpenQueryA(
[in] LPCSTR szDataSource,
[in] DWORD_PTR dwUserData,
[out] PDH_HQUERY *phQuery
);
パラメーター
[in] szDataSource
パフォーマンス データの取得元となるログ ファイルの名前を指定する Null で終わる文字列。 NULL の場合、パフォーマンス データはリアルタイム データ ソースから収集されます。
[in] dwUserData
このクエリに関連付けるユーザー定義値。 後でユーザー データを取得するには、PdhGetCounterInfo を呼び出し、PDH_COUNTER_INFOの dwQueryUserData メンバーにアクセスします。
[out] phQuery
クエリを処理します。 このハンドルは、後続の呼び出しで使用します。
戻り値
関数が成功すると、ERROR_SUCCESSが返されます。
関数が失敗した場合、戻り値は システム エラー コード または PDH エラー コードです。
解説
注意
pdh.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして PdhOpenQuery を定義します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | pdh.h |
| Library | Pdh.lib |
| [DLL] | Pdh.dll |