PdhSetDefaultRealTimeDataSource 関数 (pdh.h)

リアルタイムデータのソースを指定します。

構文

PDH_FUNCTION PdhSetDefaultRealTimeDataSource(
  [in] DWORD dwDataSourceId
);

[in] dwDataSourceId

パフォーマンスデータのソース。このパラメーターには、次の値のいずれかを指定できます。

値	意味
DATA_SOURCE_REGISTRY	データソースはレジストリインターフェイスです。既定値です。
DATA_SOURCE_WBEM	データソースは WMI プロバイダーです。

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

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

リターンコード	説明
PDH_INVALID_ARGUMENT	パラメーターが有効ではありません。

この関数の説明で使用される リアルタイムという用語 は、リアルタイム という用語の標準的な意味を意味するものではありません。代わりに、ログファイルからではなく、現在の情報 (レジストリや WMI プロバイダーなど) を提供するソースからのパフォーマンスデータの収集について説明します。

WMI からリアルタイムデータのクエリを実行する場合は、 PdhSetDefaultRealTimeDataSource を呼び出して、既定のリアルタイムデータソースを設定する必要があります。他の PDH API 関数を呼び出す前に、この関数を呼び出す必要があります。