Fungsi PerfEnumerateCounterSet (perflib.h)

Artikel
03/01/2024

Mendapatkan pengidentifikasi set penghitung dari set penghitung yang terdaftar di

sistem yang ditentukan.

Pengidentifikasi set penghitung adalah pengidentifikasi unik global (GUID).

Sintaks

ULONG PerfEnumerateCounterSet(
  [in, optional]  LPCWSTR szMachine,
  [out, optional] LPGUID  pCounterSetIds,
                  DWORD   cCounterSetIds,
  [out]           LPDWORD pcCounterSetIdsActual
);

Parameter

[in, optional] szMachine

Nama mesin untuk mendapatkan pengidentifikasi set penghitung. Jika NULL, fungsi mengambil pengidentifikasi set penghitung untuk komputer lokal.

[out, optional] pCounterSetIds

Penunjuk ke buffer yang memiliki cukup ruang untuk menerima jumlah GUID yang ditentukan parameter cCounterSetIds . Mungkin NULL jika

cCounterSetIds adalah 0.

cCounterSetIds

Ukuran buffer yang ditentukan parameter pCounterSetIds , yang diukur dalam GUID.

[out] pcCounterSetIdsActual

Ukuran buffer sebenarnya diperlukan untuk mendapatkan pengidentifikasi set penghitung. Arti tergantung pada nilai fungsi

Kembali.

Nilai Pengembalian Fungsi	Arti dari pcCounterSetIdsActual
ERROR_SUCCESS	Jumlah GUID yang disimpan fungsi dalam buffer yang ditentukan pCounterSetIds .
ERROR_NOT_ENOUGH_MEMORY	The ukuran (dalam GUID) dari buffer yang diperlukan. Memperbesar buffer ke yang diperlukan ukuran dan panggil fungsi lagi.
Lainnya	Nilai tidak ditentukan dan tidak boleh digunakan.

Nilai Pengembalian Fungsi

Arti dari pcCounterSetIdsActual

ERROR_SUCCESS

Jumlah

GUID yang disimpan fungsi dalam buffer yang ditentukan pCounterSetIds .

ERROR_NOT_ENOUGH_MEMORY

The

ukuran (dalam GUID) dari buffer yang diperlukan. Memperbesar buffer ke yang diperlukan

ukuran dan panggil fungsi lagi.

Lainnya

Nilai tidak ditentukan dan tidak boleh digunakan.

Nilai kembali

Menampilkan kode	Deskripsi
ERROR_SUCCESS	Fungsi berhasil menyimpan semua pengidentifikasi kumpulan konten di buffer yang ditentukan pCounterSetIds . Nilai yang ditunjukkan pcCounterSetIdsActual menunjukkan jumlah pengidentifikasi set penghitung yang benar-benar disimpan dalam buffer.
ERROR_NOT_ENOUGH_MEMORY	Buffer yang ditentukan pCounterSetIds tidak cukup besar untuk menyimpan semua pengidentifikasi set penghitung untuk set penghitung pada sistem yang ditentukan. Nilai yang ditunjukkan pcCounterSetIdsActual menunjukkan ukuran buffer yang diperlukan untuk menyimpan semua pengidentifikasi set penghitung. Memperbesar buffer ke yang diperlukan ukuran dan panggil fungsi lagi.

Untuk jenis kegagalan lainnya, nilai yang dikembalikan adalah kode kesalahan sistem.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1607 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2016 [hanya aplikasi desktop]
Target Platform	Windows
Header	perflib.h
Pustaka	AdvAPI32.lib
DLL	AdvAPI32.dll

Lihat juga

PerfEnumerateCounterSetInstances

Bagikan melalui