Fungsi PerfQueryInstance (perflib.h)

Mengambil pointer ke instans set penghitung yang ditentukan. Penyedia menggunakan fungsi ini.

Sintaks

PPERF_COUNTERSET_INSTANCE PerfQueryInstance(
  [in] HANDLE  ProviderHandle,
  [in] LPCGUID CounterSetGuid,
  [in] PCWSTR  Name,
  [in] ULONG   Id
);

Parameter

[in] ProviderHandle

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] CounterSetGuid

GUID yang secara unik mengidentifikasi kumpulan penghitung yang ingin Anda kueri. Ini adalah GUID yang sama yang ditentukan dalam atribut guid dari elemen counterSet . Gunakan variabel GUID yang dihasilkan alat CTRPP untuk Anda. Untuk nama variabel, lihat atribut simbol dari elemen counterSet .

Windows Vista: Variabel GUID tidak tersedia.

[in] Name

String Unicode yang dihentikan null yang berisi nama instans set penghitung yang ingin Anda ambil.

[in] Id

Pengidentifikasi unik instans set penghitung yang ingin Anda ambil.

Menampilkan nilai

Struktur PERF_COUNTERSET_INSTANCE yang berisi instans set penghitung atau NULL jika instans tidak ada.

Fungsi ini mengembalikan NULL jika terjadi kesalahan. Untuk menentukan kesalahan yang terjadi, panggil GetLastError.

Keterangan

Gunakan nama instans dan pengidentifikasi yang sama dengan yang Anda gunakan saat memanggil PerfCreateInstance untuk mengambil instans tertentu dari set penghitung.

Penyedia harus menyimpan penunjuk ke instans saat mereka membuat instans alih-alih memanggil fungsi ini untuk mengambil penunjuk.

Persyaratan

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

PerfCreateInstance