Metode IWDTFTarget2::GetRelations (wdtf.h)

Mengembalikan kumpulan target terkait.

Sintaks

HRESULT GetRelations(
  [in]          BSTR          RelationSDEL,
  [in]          BSTR          MatchSDEL,
  [out, retval] IWDTFTargets2 **ppRelations
);

Parameter

[in] RelationSDEL

Pernyataan SDEL yang berisi satu atau beberapa token relasi yang menentukan target yang diinginkan.

[in] MatchSDEL

Pernyataan SDEL yang harus dicocokkan dengan setiap target yang dikembalikan. Jika MatchSDEL kosong, semua target dikembalikan.

[out, retval] ppRelations

Alamat variabel yang akan menerima hasil metode ini.

Nilai kembali

Jika metode ini berhasil, metode akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Anda menggunakan metode GetRelations untuk mengambil instans terkait antarmuka IWDTFTarget2 . Anda menentukan target yang diinginkan oleh pernyataan SDEL hubungan. Biasanya, pernyataan SDEL dapat berisi token atribut, operator perbandingan, dan penentu nilai untuk melakukan kecocokan. Namun, Anda tidak memerlukan item ini dalam parameter RelationSDEL agar metode GetRelations berfungsi dengan baik (parameter MatchSDEL mengikuti aturan untuk metode IWDTFTarget2::Eval ).

Metode IWDTFTarget2:GetRelations menempatkan setiap target terkait yang ditemukan GetRelations oleh pernyataan RelationSDEL ke dalam koleksi baru.

GetRelations hanya mengembalikan subset target yang memenuhi batasan parameter MatchSDEL . Jika string parameter MatchSDEL kosong, GetRelations mengembalikan seluruh kumpulan target. Proses ini memfilter semua target yang mengembalikan VARIANT_FALSE saat Anda memberikan MatchSDEL ke metode IWDTFTarget2::Eval target.

Untuk informasi selengkapnya tentang menggunakan metode GetRelations , 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