PdhUpdateLogA 関数 (pdh.h)

  • [アーティクル]

現在のクエリのカウンター データを収集し、ログ ファイルにデータを書き込みます。

構文

PDH_FUNCTION PdhUpdateLogA(
  [in] PDH_HLOG hLog,
  [in] LPCSTR   szUserString
);

パラメーター

[in] hLog

更新する 1 つのログ ファイルのハンドル。 PdhOpenLog 関数は、このハンドルを返します。

[in] szUserString

データ レコードに追加するユーザー定義コメントを含む Null で終わる文字列。 文字列を空にすることはできません。

戻り値

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

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

リターン コード 説明
PDH_INVALID_HANDLE
 ログ ファイル ハンドルが無効です。
PDH_INVALID_ARGUMENT
 szUserString パラメーターに空の文字列が渡されました。

注釈

別のログ ファイルからログ ファイルを更新する場合、他のログ ファイルからのコメントは移行されません。

例

例については、「 ログ ファイルへのパフォーマンス データの書き込み」を参照してください。

注意

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

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー pdh.h
Library Pdh.lib
[DLL] Pdh.dll

こちらもご覧ください

PdhGetLogFileSize

PdhOpenLog

PdhOpenQuery

PdhUpdateLogFileCatalog