Fungsi PerfIncrementULongCounterValue (perflib.h)

Artikel
03/08/2023

Menaikkan nilai penghitung yang nilainya adalah bilangan bulat tanpa tanda 4 byte. Penyedia menggunakan fungsi ini.

Sintaks

ULONG PerfIncrementULongCounterValue(
  [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 untuk menaikkan penghitung.

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 meningkatkan data penghitung mentah. Untuk menaikkan 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.

Gunakan fungsi PerfSetULongCounterValue untuk awalnya mengatur nilai penghitung.

Perhatikan bahwa nilai penghitung akan meluap ketika nilai penghitung naik melewati ukuran maksimum bilangan bulat yang tidak ditandatangani 4-byte.

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

PerfIncrementULongLongCounterValue

PerfSetULongCounterValue

Bagikan melalui