Fungsi PdhVbUpdateLog

Fungsi PdhVbUpdateLog memperbarui kueri saat ini dan menulis data baru ke file log. Fungsi ini memanggil PdhUpdateLog.

Penting

Fungsi yang dijelaskan topik ini dapat diubah atau tidak tersedia di masa mendatang. Sebagai gantinya, Microsoft menyarankan agar Anda menggunakan fungsi yang dijelaskan dalam Fungsi Penghitung Kinerja.

Fungsi PdhVbUpdateLog( _ ByVal hLog As PDH_HLOG, _ ByVal szUserString As LPCTSTR _ )

Parameter

hLog [in]

Tangani ke file log yang akan diperbarui. Handel ini dikembalikan oleh fungsi PdhVbOpenLog .

szUserString [in]

Penunjuk ke string yang menentukan data yang akan ditambahkan ke file log. Ini umumnya digunakan untuk komentar dalam file log.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan 0.

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

Menampilkan kode	Deskripsi
PDH_INSUFFICIENT_BUFFER	Data yang diminta lebih besar dari buffer yang disediakan. Tidak dapat mengembalikan data yang diminta.
PDH_INVALID_ARGUMENT	Satu atau beberapa buffer string bukan ukuran yang benar.
PDH_INVALID_HANDLE	Handel bukanlah objek PDH yang valid.
PDH_LOG_FILE_OPEN_ERROR	Tidak dapat membuka file log yang ditentukan.
PDH_FILE_NOT_FOUND	Tidak dapat menemukan file yang ditentukan.

Keterangan

Harus ada kueri yang saat ini dibuka, dan penghitung yang diinginkan harus ditambahkan ke dalamnya sebelum fungsi ini dipanggil.

Persyaratan

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

Lihat juga

PdhUpdateLog

PdhVbGetLogFileSize

PdhVbOpenLog