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

PerfIncrementULongCounterValue

PerfSetCounterRefValue

PerfSetULongLongCounterValue