Fungsi PdhConnectMachineA (pdh.h)
Menyambungkan ke komputer yang ditentukan.
Sintaksis
PDH_FUNCTION PdhConnectMachineA(
[in] LPCSTR szMachineName
);
Parameter
[in] szMachineName
String nulldihentikan yang menentukan nama komputer yang akan disambungkan. Jika NULL, PDH tersambung ke komputer lokal.
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 |
|---|---|
|
Tidak dapat tersambung ke komputer yang ditentukan. Bisa disebabkan oleh komputer tidak menyala, tidak mendukung PDH, tidak tersambung ke jaringan, atau memiliki izin yang diatur pada registri yang mencegah koneksi jarak jauh atau pemantauan performa jarak jauh oleh pengguna. |
|
Tidak dapat mengalokasikan blok memori dinamis. Terjadi ketika ada kekurangan memori serius dalam sistem karena terlalu banyak aplikasi yang berjalan pada sistem atau file halaman memori yang tidak mencukup. |
Komentar
Biasanya, aplikasi tidak memanggil fungsi ini dan sebaliknya koneksi dibuat ketika aplikasi menambahkan penghitung ke kueri.
Namun, Anda dapat menggunakan fungsi ini jika Anda ingin menyertakan lebih dari komputer lokal dalam daftar
Nota
Header pdh.h mendefinisikan PdhConnectMachine sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praproscesor 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 |