Fungsi PdhParseInstanceNameA (pdh.h)

Artikel
11/20/2024

Mengurai elemen string instans.

Sintaksis

PDH_FUNCTION PdhParseInstanceNameA(
  [in]      LPCSTR  szInstanceString,
  [out]     LPSTR   szInstanceName,
  [in, out] LPDWORD pcchInstanceNameLength,
  [out]     LPSTR   szParentName,
  [in, out] LPDWORD pcchParentNameLength,
  [out]     LPDWORD lpIndex
);

Parameter

[in] szInstanceString

String nulldihentikan yang menentukan string instans untuk diurai menjadi komponen individual. String ini dapat berisi format berikut, dan panjangnya kurang dari MAX_PATH karakter:

Sebagai contoh
instance#index
induk/instans
induk/instans#indeks

[out] szInstanceName

Buffer yang dialokasikan pemanggil yang menerima nama instans nulldihentikan. Atur ke NULL jika pcchInstanceNameLength adalah nol.

[in, out] pcchInstanceNameLength

Ukuran buffer szInstanceName , 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.

[out] szParentName

Buffer yang dialokasikan pemanggil yang menerima namanull dihentikan dari instans induk, jika ditentukan. Atur ke NULL jika pcchParentNameLength adalah nol.

[in, out] pcchParentNameLength

Ukuran buffer szParentName , 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.

[out] lpIndex

Nilai indeks instans. Jika entri indeks tidak ada dalam string, maka nilai ini adalah nol. Parameter ini dapat null.

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_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.
PDH_MORE_DATA	Satu atau kedua buffer string terlalu kecil untuk berisi data. Nilai pengembalian ini diharapkan jika buffer ukuran yang sesuai 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_INSTANCE	String instans salah diformat, melebihi panjang MAX_PATH karakter, atau tidak dapat diurai.

Komentar

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

Nota

Header pdh.h mendefinisikan PdhParseInstanceName 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

Lihat juga

PdhMakeCounterPath

Bagikan melalui