Fungsi PdhUpdateLogA (pdh.h)

Artikel
11/20/2024

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

Sintaksis

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

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

Mengembalikan nilai

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.

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

Komentar

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.

Nota

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

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

Lihat juga

PdhGetLogFileSize

PdhOpenLog

PdhOpenQuery

PdhUpdateLogFileCatalog

Bagikan melalui