Bagikan melalui

Fungsi PdhValidatePathA (pdh.h)

  • Artikel

Memvalidasi bahwa penghitung ada di komputer yang ditentukan di jalur penghitung.

Sintaksis

PDH_FUNCTION PdhValidatePathA(
  [in] LPCSTR szFullPathBuffer
);

Parameter

[in] szFullPathBuffer

String yang dihentikan null yang berisi jalur penghitung untuk divalidasi. Panjang maksimum jalur penghitung adalah PDH_MAX_COUNTER_PATH.

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_CSTATUS_NO_INSTANCE
 Instans objek performa yang ditentukan tidak ditemukan.
PDH_CSTATUS_NO_COUNTER
 Penghitung yang ditentukan tidak ditemukan di objek performa.
PDH_CSTATUS_NO_OBJECT
 Objek performa yang ditentukan tidak ditemukan pada komputer.
PDH_CSTATUS_NO_MACHINE
 Komputer yang ditentukan tidak dapat ditemukan atau tersambung.
PDH_CSTATUS_BAD_COUNTERNAME
 String jalur penghitung tidak dapat diurai.
PDH_MEMORY_ALLOCATION_FAILURE
 Fungsi ini tidak dapat mengalokasikan buffer sementara yang diperlukan.

Komentar

Nota

Header pdh.h mendefinisikan PdhValidatePath sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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

PdhMakeCounterPath