CFrameworkQuery::GetValuesForProp(LPCWSTR,CHStringArray&) metode (frquery.h)

[Kelas CFrameworkQuery adalah bagian dari WMI Provider Framework yang sekarang dipertimbangkan dalam keadaan akhir, dan tidak ada pengembangan, penyempurnaan, atau pembaruan lebih lanjut yang akan tersedia untuk masalah terkait non-keamanan yang memengaruhi pustaka ini. API MI harus digunakan untuk semua pengembangan baru.]

Metode GetValuesForProp mengembalikan semua nilai untuk properti tertentu yang dihasilkan oleh properti tersebut saat muncul dalam kueri.

Misalnya, panggilan ke GetValuesForProp(L"Name", sa) mengembalikan array sa, yang berisi semua nilai "Name" yang mengharuskan instans dikirim kembali untuk memenuhi kueri. Jika sa berisi {"a","b"}, maka semua instans di mana "Name=a" ditambah semua instans di mana "Name=b" harus dikirim kembali untuk sepenuhnya memenuhi kueri.

Jika batasan pada "Nama" tidak cukup membatasi, array sa kosong akan dikembalikan.

Sintaks

HRESULT GetValuesForProp(
  LPCWSTR         wszPropName,
  CHStringArray & achNames
);

Parameter

wszPropName

Array nilai untuk properti yang ditentukan oleh wszPropName.

achNames

Nama properti target.

Menampilkan nilai

Metode ini mengembalikan WBEM_S_NO_ERROR pada keberhasilan, dan WBEM_E_FAILED, atau kode kesalahan HRESULT lainnya, jika gagal.

Keterangan

Dengan nama properti, metode ini mengembalikan semua nilai hasil dalam kontainer CHStringArray atau vektor. Kontainer vektor menyimpan objek _bstr_t yang berisi nilai hasil.

Misalnya, daftar berikut mencantumkan nilai yang dikembalikan oleh GetValuesForProp untuk berbagai kueri saat dipanggil dengan wszPropName diatur ke "Drive".

Kueri	Mengembalikan nilai	Hasil
SELECT * FROMWin32_Directory MANA Drive = "C:"	WBEM_S_NO_ERROR	C:
SELECT * FROMWin32_Directory MANA Drive = "C:" ATAU Ukuran File = 256	WBEM_S_NO_ERROR	Tidak ada hasil; aszNames kosong.
SELECT * FROMWin32_Directory MANA Drive = "C:" OR Drive = "D:"	WBEM_S_NO_ERROR	C:, D:
SELECT * FROMWin32_Directory MANA Drive <> "C:"	WBEM_S_NO_ERROR	Tidak ada hasil; aszNames kosong.
SELECT * FROMWin32_Directory Jalur WHERE = "\DOS"	WBEM_S_NO_ERROR	Tidak ada hasil; aszNames kosong.

 

Metode GetValuesForProp hanya mendukung jenis string. Misalnya, kueri berikut, diikuti dengan panggilan ke GetValuesForProp("PropInt", nilai), mengembalikan WBEM_E_INVALID_QUERY sementara GetValuesForProp("PropStr", nilai) mengembalikan S_OK.

SELECT * FROM Test WHERE PropInt = 32 AND PropStr = "a"

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	frquery.h (termasuk FwCommon.h)
Pustaka	FrameDyn.lib
DLL	FrameDynOS.dll; FrameDyn.dll

Lihat juga

CFrameworkQuery

Provider::ExecQuery