Fungsi PdhOpenLogA (pdh.h)
Membuka file log yang ditentukan untuk membaca atau menulis.
Sintaks
PDH_FUNCTION PdhOpenLogA(
[in] LPCSTR szLogFileName,
[in] DWORD dwAccessFlags,
[in] LPDWORD lpdwLogType,
[in] PDH_HQUERY hQuery,
[in] DWORD dwMaxSize,
[in] LPCSTR szUserCaption,
[out] PDH_HLOG *phLog
);
Parameter
[in] szLogFileName
String yang dihentikan null yang menentukan nama file log yang akan dibuka. Nama dapat berisi jalur absolut atau relatif.
Jika parameter lpdwLogTypePDH_LOG_TYPE_SQL, tentukan nama file log dalam formulir, SQL:DataSourceName!LogFileName.
[in] dwAccessFlags
Jenis akses yang akan digunakan untuk membuka file log. Tentukan salah satu nilai berikut.
Nilai | Makna |
---|---|
|
Buka file log untuk dibaca. |
|
Buka file log baru untuk menulis. |
|
Buka file log yang ada untuk menulis. |
Anda bisa menggunakan operator OR inklusif bitwise (|) untuk menggabungkan tipe akses dengan satu atau beberapa bendera pembuatan berikut.
Nilai | Makna |
---|---|
|
Membuat file log baru dengan nama yang ditentukan. |
|
Membuat file log baru dengan nama yang ditentukan. Jika file log sudah ada, fungsi akan menghapus file log yang ada sebelum membuat file baru. |
|
Membuka file log yang ada dengan nama yang ditentukan. Jika file log dengan nama yang ditentukan tidak ada, ini sama dengan PDH_LOG_CREATE_NEW. |
|
Membuka file log yang ada dengan nama yang ditentukan atau membuat file log baru dengan nama yang ditentukan. |
|
Membuat file log melingkar dengan nama yang ditentukan. Ketika file mencapai nilai parameter dwMaxSize , data dibungkus ke awal file log. Anda hanya dapat menentukan bendera ini jika parameter lpdwLogTypePDH_LOG_TYPE_BINARY. |
|
Digunakan dengan PDH_LOG_TYPE_TSV untuk menulis caption pengguna atau deskripsi file log yang ditunjukkan oleh parameter szUserString dari PdhUpdateLog atau PdhOpenLog. Deskripsi file caption atau log pengguna ditulis sebagai kolom terakhir di baris pertama log teks. |
[in] lpdwLogType
Jenis file log yang akan dibuka. Parameter ini bisa menjadi salah satu nilai berikut.
[in] hQuery
Tentukan handel kueri jika Anda menulis data kueri ke file log. Fungsi PdhOpenQuery mengembalikan handel ini.
Parameter ini diabaikan dan harus NULL jika Anda membaca dari file log.
[in] dwMaxSize
Ukuran maksimum file log, dalam byte. Tentukan ukuran maksimum jika Anda ingin membatasi ukuran file atau jika dwAccessFlags menentukan PDH_LOG_OPT_CIRCULAR; jika tidak, atur ke 0.
Untuk file log melingkar, Anda harus menentukan nilai yang cukup besar untuk menyimpan setidaknya satu sampel. Ukuran sampel tergantung pada data yang dikumpulkan. Namun, menentukan nilai setidaknya satu megabyte akan mencakup sebagian besar sampel.
[in] szUserCaption
String yang dihentikan null yang menentukan caption yang ditentukan pengguna dari file log. File log caption umumnya menjelaskan konten file log. Ketika file log yang ada dibuka, nilai parameter ini diabaikan.
[out] phLog
Tangani ke file log yang dibuka.
Nilai kembali
Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS.
Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem atau kode kesalahan PDH.
Keterangan
Untuk menggunakan fungsi ini untuk menulis data performa ke file log, Anda harus membuka kueri menggunakan PdhOpenQuery dan menambahkan penghitung yang diinginkan ke dalamnya, sebelum memanggil fungsi ini.
Sistem operasi yang lebih baru dapat membaca file log yang dihasilkan pada sistem operasi yang lebih lama; namun, file log yang dibuat pada Windows Vista dan sistem operasi yang lebih baru tidak dapat dibaca pada sistem operasi sebelumnya.
Aturan berikut berlaku untuk file log
READ_ACCESS membutuhkan OPEN_EXISTING.
UPDATE_ACCESS tidak dapat digunakan dengan log berbasis file. Ini hanya dapat digunakan dengan log database.
WRITE_ACCESS membutuhkan salah satu CREATE_NEW, CREATE_ALWAYS, OPEN_EXISTING, OPEN_ALWAYS.
Contoh
Misalnya, lihat Menulis Data Performa ke File Log.
Catatan
Header pdh.h mendefinisikan PdhOpenLog sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk