Fungsi PdhValidatePathExW (pdh.h)

Artikel
11/20/2024

Memvalidasi bahwa penghitung yang ditentukan ada di komputer atau dalam file log.

Sintaksis

PDH_FUNCTION PdhValidatePathExW(
  [in, optional] PDH_HLOG hDataSource,
  [in]           LPCWSTR  szFullPathBuffer
);

Parameter

[in, optional] hDataSource

Tangani ke sumber data. Fungsi PdhOpen Log dan PdhBindInputDataSource mengembalikan handel ini.

Untuk memvalidasi bahwa penghitung ada di komputer lokal, tentukan NULL (ini sama dengan memanggil PdhValidatePath).

[in] szFullPathBuffer

String nulldihentikan yang menentukan 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 atau dalam file log.
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 PdhValidatePathEx 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 Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Platform Target	Windows
Header	pdh.h
Pustaka	Pdh.lib
DLL	Pdh.dll

Lihat juga

PdhMakeCounterPath

PdhValidatePath

Bagikan melalui