Fungsi PdhEnumObjectItemsHA (pdh.h)

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

Fungsi ini identik dengan fungsi PdhEnumObjectItems, kecuali mendukung penggunaan handel ke sumber data.

Sintaksis

PDH_FUNCTION PdhEnumObjectItemsHA(
  [in]      PDH_HLOG hDataSource,
  [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] hDataSource

Tangani ke sumber data yang dikembalikan oleh fungsi PdhBindInputDataSource.

[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 parameter 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 PdhEnumObjectItemsH akan selalu mengkueri daftar objek performa yang ditentukan oleh panggilan terakhir ke PdhEnumObjectsH atau PdhEnumObjectItemsH. Untuk merefresh daftar objek performa, panggil PdhEnumObjectsH dengan nilai bendera bRefresh TRUE sebelum memanggil PdhEnumObjectItemsH lagi.

Urutan nama instans dan penghitung tidak ditentukan.

Persyaratan

Lihat juga

PdhBindInputDataSource

PdhEnumObjectsH