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

Lihat juga

IWDTFTarget2