Fungsi PerfDeleteInstance (perflib.h)
Menghapus instans set penghitung yang dibuat oleh fungsi PerfCreateInstance . Penyedia menggunakan fungsi ini.
Sintaks
ULONG PerfDeleteInstance(
[in] HANDLE Provider,
[in] PPERF_COUNTERSET_INSTANCE InstanceBlock
);
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] InstanceBlock
Struktur PERF_COUNTERSET_INSTANCE yang berisi instans penghitung yang diatur untuk dihapus.
Nilai kembali
Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS.
Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem.
Keterangan
Jika proses penyedia berakhir secara tidak normal, semua instans yang dialokasikan akan dirilis.
Penyedia menentukan kapan instans dihapus. Jika data penghitung lebih statis, penyedia dapat menghapus instans pada waktu pembersihan. Misalnya, jumlah prosesor di komputer akan dianggap statis, sehingga penyedia yang menyediakan data penghitung untuk prosesor dapat menghapus instans untuk setiap prosesor di komputer pada waktu pembersihan. Untuk penghitung yang lebih dinamis, seperti disk atau penghitung proses, penyedia akan menghapus instans sebagai respons terhadap perangkat USB yang dihapus atau proses dihentikan.
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 |