Fungsi PdhEnumObjectItemsA (pdh.h)

Mengembalikan penghitung objek dan nama instans yang ditentukan yang ada di komputer yang ditentukan atau dalam file log yang ditentukan.

Untuk menggunakan handel ke sumber data, gunakan fungsi PdhEnumObjectItemsH.

Sintaksis

PDH_FUNCTION PdhEnumObjectItemsA(
  [in]      LPCSTR  szDataSource,
  [in]      LPCSTR  szMachineName,
  [in]      LPCSTR  szObjectName,
  [out]     PZZSTR  mszCounterList,
  [in, out] LPDWORD pcchCounterListLength,
  [out]     PZZSTR  mszInstanceList,
  [in, out] LPDWORD pcchInstanceListLength,
  [in]      DWORD   dwDetailLevel,
  [in]      DWORD   dwFlags
);

Parameter

[in] szDataSource

String null-dihentikan yang menentukan nama file log yang digunakan untuk menghitung penghitung dan nama instans. Jika NULL, fungsi menggunakan komputer yang ditentukan dalam

parameter szMachineName untuk menghitung nama.

[in] szMachineName

String null-dihentikan yang menentukan nama komputer yang berisi penghitung dan nama instans yang ingin Anda hitung.

Sertakan garis miring di depan dalam nama komputer, misalnya, \computername.

Jika parameter szDataSource NULL, Anda dapat mengatur szMachineName ke NULL untuk menentukan komputer lokal.

[in] szObjectName

String nulldihentikan yang menentukan nama objek yang penghitung dan nama instansnya ingin Anda hitung.

[out] mszCounterList

Buffer yang dialokasikan pemanggil yang menerima daftar nama penghitungnull dihentikan yang disediakan oleh objek yang ditentukan. Daftar berisi nama penghitung unik. Daftar dihentikan oleh dua karakter NULL. Atur ke NULL jika parameter pcchCounterListLength adalah nol.

[in, out] pcchCounterListLength

Ukuran buffer mszCounterList , dalam TCHAR. Jika nol pada input dan objek ada, fungsi mengembalikan PDH_MORE_DATA dan mengatur parameter ini ke ukuran buffer yang diperlukan. Jika buffer lebih besar dari ukuran yang diperlukan, fungsi mengatur parameter ini ke ukuran buffer aktual yang digunakan. Jika ukuran yang ditentukan pada input lebih besar dari nol tetapi kurang dari ukuran yang diperlukan, Anda tidak boleh mengandalkan ukuran yang dikembalikan untuk merealokasi buffer.

[out] mszInstanceList

Buffer yang dialokasikan pemanggil yang menerima daftar nama instans nulldihentikan yang disediakan oleh objek yang ditentukan. Daftar berisi nama instans unik. Daftar dihentikan oleh dua karakter NULL. Atur ke NULL jika pcchInstanceListLength adalah nol.

[in, out] pcchInstanceListLength

Ukuran buffer mszInstanceList , dalam TCHAR. Jika nol pada input dan objek ada, fungsi mengembalikan PDH_MORE_DATA dan mengatur parameter ini ke ukuran buffer yang diperlukan. Jika buffer lebih besar dari ukuran yang diperlukan, fungsi mengatur parameter ini ke ukuran buffer aktual yang digunakan. Jika ukuran yang ditentukan pada input lebih besar dari nol tetapi kurang dari ukuran yang diperlukan, Anda tidak boleh mengandalkan ukuran yang dikembalikan untuk merealokasi buffer.

Jika objek yang ditentukan tidak mendukung instans variabel, maka nilai yang dikembalikan akan menjadi nol. Jika objek yang ditentukan mendukung instans variabel, tetapi saat ini tidak memiliki instans apa pun, maka nilai yang dikembalikan adalah 2, yang merupakan ukuran string daftar MULTI_SZ kosong.

[in] dwDetailLevel

Tingkat detail item performa yang akan dikembalikan. Semua item yang berada di tingkat detail yang ditentukan atau kurang akan dikembalikan (tingkat dicantumkan dalam urutan yang meningkat). Parameter ini bisa menjadi salah satu nilai berikut.

[in] dwFlags

Parameter ini harus nol.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem atau kode kesalahan PDH . Berikut ini adalah nilai yang mungkin.

Komentar

Anda harus memanggil fungsi ini dua kali, pertama kalinya untuk mendapatkan ukuran buffer yang diperlukan (atur buffer ke null dan ukuran ke 0), dan kedua kalinya untuk mendapatkan data.

Panggilan berturut-turut ke fungsi ini akan mengembalikan daftar penghitung dan instans yang identik, karena PdhEnumObjectItems akan selalu mengkueri daftar objek performa yang ditentukan oleh panggilan terakhir ke PdhEnumObjects atau PdhEnumObjectItems. Untuk menyegarkan daftar objek performa, panggil PdhEnumObjects dengan nilai bendera bRefresh TRUE sebelum memanggil PdhEnumObjectItems lagi.

Urutan nama instans dan penghitung tidak ditentukan.

Contoh

Misalnya, lihat Menghitung Objek Proses.

Persyaratan

Lihat juga

PdhEnumObjectItemsH

PdhEnumObjects