次の方法で共有

PdhSelectDataSourceW 関数 (pdh.h)

  • [アーティクル]

パフォーマンス データのソースを指定するようにユーザーに求めるダイアログ ウィンドウを表示します。

構文

PDH_FUNCTION PdhSelectDataSourceW(
  [in]      HWND    hWndOwner,
  [in]      DWORD   dwFlags,
  [out]     LPWSTR  szDataSource,
  [in, out] LPDWORD pcchBufferLength
);

パラメーター

[in] hWndOwner

ダイアログ ウィンドウの所有者。 所有者が存在しない場合 (デスクトップが所有者になる) 場合は、null を できます。

[in] dwFlags

データ ソースの入力を求めるダイアログ ボックスが表示されます。 このパラメーターには、次のいずれかの値を指定できます。

価値 意味
PDH_FLAGS_FILE_BROWSER_ONLY
 ファイル ブラウザーのみを表示します。 ログ ファイルの名前と場所のみを求めるメッセージを表示する場合は、このフラグを設定します。
0
 データ ソースの選択ダイアログ ボックスを表示します。 このダイアログ ボックスを使用すると、ユーザーはログ ファイルまたはリアルタイム ソースからパフォーマンス データを選択できます。 ユーザーがログ ファイルからデータを収集することを指定した場合、ユーザーがログ ファイルの名前と場所を指定するためのファイル ブラウザーが表示されます。

[out] szDataSource

ユーザーが選択したログ ファイルの名前を含む、null-terminated 文字列を受け取る呼び出し元によって割り当てられたバッファー。 バッファーが小さすぎる場合、ログ ファイル名はバッファーのサイズに切り捨てられます。

ユーザーがリアルタイム ソースを選択した場合、バッファーは空です。

[in, out] pcchBufferLength

szDataSource バッファーの最大サイズ (TCHAR)。

戻り値

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

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

リターン コード 形容
PDH_INVALID_ARGUMENT
 pcchBufferLength で渡されるバッファーの長さは、szDataSource バッファーの実際の長さと等しくありません。
PDH_MEMORY_ALLOCATION_FAILURE
 szDataSource パラメーターに長さ 0 のバッファーが渡されました。

備考

手記

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

必要条件

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

関連項目

PdhIsRealTimeQuery