Fungsi PerfSetULongCounterValue (perflib.h)
Updates nilai penghitung yang nilainya adalah bilangan bulat tanpa tanda 4 byte. Penyedia menggunakan fungsi ini.
Sintaks
ULONG PerfSetULongCounterValue(
[in] HANDLE Provider,
[in] PPERF_COUNTERSET_INSTANCE Instance,
[in] ULONG CounterId,
[in] ULONG Value
);
Parameter
[in] Provider
Handel penyedia. Gunakan variabel handel yang dihasilkan alat CTRPP untuk Anda. Untuk nama variabel, lihat atribut simbol elemen penyedia .
Windows Vista: Fungsi PerfStartProvider mengembalikan handel.
[in] Instance
Struktur PERF_COUNTERSET_INSTANCE yang berisi instans set penghitung. Fungsi PerfCreateInstance mengembalikan penunjuk ini.
[in] CounterId
Pengidentifikasi yang secara unik mengidentifikasi penghitung untuk diperbarui di blok instans. Pengidentifikasi didefinisikan dalam atribut id elemen penghitung dan harus cocok dengan anggota CounterId dari salah satu struktur PERF_COUNTER_INFO di blok instans. Gunakan konstanta ID penghitung yang dihasilkan alat CTRPP untuk Anda. Untuk nama konstanta, lihat atribut simbol elemen penghitung .
Windows Vista: Konstanta ID penghitung tidak tersedia.
[in] Value
Nilai penghitung 4 byte baru.
Nilai kembali
Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS.
Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem.
Keterangan
Ini adalah fungsi kenyamanan untuk mengatur data penghitung mentah. Untuk memperbarui data penghitung mentah sendiri, gunakan anggota Offset dari struktur PERF_COUNTER_INFO untuk mengakses data penghitung mentah untuk penghitung tertentu. Blok struktur PERF_COUNTERSET_INSTANCE berisi satu atau beberapa struktur informasi penghitung.
Anda dapat menggunakan fungsi PerfIncrementULongCounterValue dan PerfDecrementULongCounterValue untuk menambah atau mengurangi nilai penghitung.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | perflib.h |
| Pustaka | Advapi32.lib |
| DLL | Advapi32.dll |
Lihat juga
PerfDecrementULongCounterValue