Bagikan melalui

Fungsi PdhEnumMachinesA (pdh.h)

  • Artikel

Mengembalikan daftar nama komputer yang terkait dengan penghitung dalam file log. Nama komputer ditentukan saat menambahkan penghitung ke kueri atau saat memanggil fungsi PdhConnectMachine . Komputer yang tercantum mencakup komputer yang saat ini tersambung dan online, selain komputer yang offline atau tidak mengembalikan data performa.

Untuk menggunakan handel ke sumber data, gunakan fungsi PdhEnumMachinesH.

Sintaksis

PDH_FUNCTION PdhEnumMachinesA(
  [in]      LPCSTR  szDataSource,
  [out]     PZZSTR  mszMachineList,
  [in, out] LPDWORD pcchBufferSize
);

Parameter

[in] szDataSource

String null-dihentikan yang menentukan nama file log. Fungsi ini menghitung nama komputer yang data penghitungnya ada di file log. Jika NULL, fungsi menghitung daftar komputer yang ditentukan saat menambahkan penghitung ke kueri real time atau saat memanggil fungsi PdhConnectMachine.

[out] mszMachineList

Buffer yang dialokasikan pemanggil untuk menerima daftar string nulldihentikan yang berisi nama komputer. Daftar dihentikan dengan dua karakter null-terminator. Atur ke NULL jika pcchBufferLength adalah nol.

[in, out] pcchBufferSize

Ukuran buffer mszMachineNameList , dalam TCHAR. Jika nol pada input, 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.

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.

Mengembalikan kode Deskripsi
PDH_MORE_DATA
 Buffer mszMachineNameList terlalu kecil untuk berisi semua data. Nilai pengembalian ini diharapkan jika pcchBufferLength adalah nol pada input. 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.
PDH_INVALID_ARGUMENT
 Parameter tidak valid. Misalnya, pada beberapa rilis, Anda dapat menerima kesalahan ini jika ukuran yang ditentukan pada input lebih besar dari nol tetapi kurang dari ukuran yang diperlukan.

Komentar

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

Nota

Header pdh.h mendefinisikan PdhEnumMachines sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat Nilai
klien minimum yang didukung Windows XP [hanya aplikasi desktop]
server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Platform Target Windows
Header pdh.h
Pustaka Pdh.lib
DLL Pdh.dll

Lihat juga

PdhConnectMachine

PdhEnumMachinesH