Metode IWDTFTarget2::GetValue (wdtf.h)
Mengembalikan nilai dari target yang terkait dengan atribut tertentu.
Sintaks
HRESULT GetValue(
[in] BSTR SDEL,
[out, retval] VARIANT *pValue
);
Parameter
[in] SDEL
Pernyataan SDEL yang menentukan nilai atribut untuk diambil.
[out, retval] pValue
Alamat variabel yang menerima hasil dari metode ini. Hasilnya bisa menjadi VARIAN yang kompatibel dengan otomatisasi.
Nilai kembali
Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.
Keterangan
Anda menentukan bidang yang diambil metode GetValue dengan menggunakan pernyataan SDEL reguler. Biasanya, pernyataan SDEL dapat berisi operator perbandingan dan penentu nilai untuk melakukan kecocokan. Namun, Anda tidak memerlukan item ini agar GetValue berfungsi dengan baik.
Untuk setiap bidang yang ditentukan dalam pernyataan SDEL (termasuk iterasi atas sekumpulan relasi), metode ini mengumpulkan sekumpulan nilai VARIAN (non-VT_EMPTY). Jika hanya satu nilai yang ditemukan, VARIAN tersebut dikembalikan. Jika lebih dari satu nilai ditemukan, nilai dikemas ke dalam VARIAN yang berisi SAFEARRAY. Jika tidak ada nilai yang ditemukan, metode mengembalikan VARIAN yang berisi VT_EMPTY.
Selain itu, operator AND akan mengizinkan pengumpulan nilai di kedua sisi itu sendiri, tetapi OR akan memungkinkan pengumpulan hanya nilai pertama yang ditemukan (dimulai dengan sebelah kiri).
Untuk informasi selengkapnya tentang menggunakan GetValue, lihat Gambaran Umum Bahasa Evaluasi Data Sederhana.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows XP Professional |
Server minimum yang didukung | Windows Server 2008 |
Target Platform | Desktop |
Header | wdtf.h |