Bagikan melalui


Memeriksa Kode Status Data Penghitung

Nilai pengembalian fungsi PDH menunjukkan keberhasilan atau kegagalan panggilan fungsi, yang berbeda dari status data penghitung. Selalu periksa anggota CStatus dari nilai penghitung yang dikembalikan dalam struktur PDH untuk memastikan bahwa data tersebut valid sebelum digunakan. Jika nilai elemen CStatus tidak menunjukkan keberhasilan, jangan gunakan data tersebut. Berikut ini adalah nilai status yang mungkin untuk penghitung:

Nilai Arti
PDH_CSTATUS_NO_MACHINE PDH tidak dapat tersambung ke komputer yang ditentukan pada jalur penghitung. Jika status ini dikembalikan ketika penghitung ditambahkan, penghitung tidak sepenuhnya diinisialisasi. Setiap kali kueri diperbarui, PDH mencoba kembali koneksi. Saat koneksi dibuat, pengumpulan data normal akan dilanjutkan.
PDH_CSTATUS_NO_OBJECT Komputer yang ditentukan ditemukan, tetapi objek performa yang ditentukan ditemukan pada komputer. Jika status ini dikembalikan saat penghitung ditambahkan, penghitung yang ditentukan tidak disertakan dalam kueri. Jika status ini dikembalikan oleh penghitung aktif, data untuk penghitung tersebut tidak valid. Setiap kali data diminta, PDH mencoba mendapatkan data penghitung ini.
PDH_CSTATUS_NO_INSTANCE Instans yang ditentukan tidak ditemukan di objek. Jika status ini dikembalikan saat penghitung ditambahkan ke kueri, penghitung berhasil ditambahkan ke kueri, tetapi tidak ada data yang tersedia sampai instans tertentu muncul dan status berhasil dikembalikan.
PDH_CSTATUS_NO_COUNTER Penghitung yang ditentukan tidak ditemukan dalam objek yang ditentukan. Jika status ini muncul saat penghitung ditambahkan, maka penghitung tidak ditambahkan ke kueri. Jika status ini dikembalikan setelah pengumpulan data, data untuk penghitung tersebut tidak valid. Setiap kali data diminta, PDH mencoba mendapatkan data penghitung ini.
PDH_CSTATUS_DATA_TIDAK_VALID Penghitung berhasil ditemukan, tetapi data yang dikembalikan tidak valid. Kesalahan ini dapat terjadi jika nilai penghitung kurang dari nilai sebelumnya. (Karena nilai penghitung selalu bertahap, nilai penghitung bergulir ke nol ketika mencapai nilai maksimumnya.) Kemungkinan penyebab lain adalah timer sistem yang tidak benar.
PDH_CSTATUS_VALID_DATA Data untuk penghitung berhasil dikembalikan, tetapi tidak berubah sejak terakhir kali penghitung dibaca.
PDH_CSTATUS_NEW_DATA Data untuk penghitung telah berhasil dikembalikan dan berbeda dari pada kali terakhir penghitung dibaca. PDH_CSTATUS_NEW_DATA dapat dikembalikan pada penghitung tarif meskipun tingkat yang dihasilkan sama dengan sampel terakhir. Ini karena nilai data mentah yang digunakan dalam penentuan nilai status ini telah berubah, bukan tingkat komputasi.
PDH_MORE_DATA Buffer yang disediakan tidak cukup besar untuk menyimpan semua data penghitung. Alokasikan buffer yang lebih besar dan jalankan fungsi lagi.
PDH_CSTATUS_ITEM_NOT_VALIDATED (Item belum divalidasi) Penghitung telah ditambahkan ke kueri, tetapi belum divalidasi dan belum diakses. Tidak ada informasi status tambahan tersedia untuk penghitung ini.
PDH_CSTATUS_NO_COUNTERNAME Tidak ada nama penghitung yang disebutkan dalam kueri.
PDH_CSTATUS_NO_COUNTER Nama penghitung yang ditentukan tidak dapat ditemukan.
PDH_CSTATUS_NO_OBJECT Objek performa yang ditentukan tidak dapat ditemukan.
PDH_CALC_NEGATIVE_DENOMINATOR (Penghitung Denominator Negatif) Penghitung memiliki nilai denominator negatif.
PDH_KALKULASI_WAKTU_NEGATIF Penghitung memiliki nilai basis waktu negatif.
PDH_CALC_NEGATIVE_VALUE Penghitung memiliki nilai negatif.
PDH_CSTATUS_NO_COUNTERNAME Tidak ada jalur penghitung yang ditentukan.
PDH_CSTATUS_BAD_COUNTERNAME (Nama penghitung buruk) Format jalur penghitung tidak benar.