Fungsi PdhUpdateLogA (pdh.h)

  • Artikel

Mengumpulkan data penghitung untuk kueri saat ini dan menulis data ke file log.

Sintaks

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

Parameter

[in] hLog

Menangani satu file log untuk diperbarui. Fungsi PdhOpenLog mengembalikan handel ini.

[in] szUserString

String yang dihentikan null yang berisi komentar yang ditentukan pengguna untuk ditambahkan ke rekaman data. String tidak boleh kosong.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem atau kode kesalahan PDH. Berikut ini adalah nilai yang mungkin.

Menampilkan kode Deskripsi
PDH_INVALID_HANDLE
 Handel file log tidak valid.
PDH_INVALID_ARGUMENT
 String kosong diteruskan dalam parameter szUserString .

Keterangan

Jika Anda memperbarui file log dari file log lain, komentar dari file log lainnya tidak bermigrasi.

Contoh

Misalnya, lihat Menulis Data Performa ke File Log.

Catatan

Header pdh.h mendefinisikan PdhUpdateLog sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header pdh.h
Pustaka Pdh.lib
DLL Pdh.dll

Lihat juga

PdhGetLogFileSize

PdhOpenLog

PdhOpenQuery

PdhUpdateLogFileCatalog