IWDTFTarget2::GetRelations-Methode (wdtf.h)
Gibt eine Auflistung verwandter Ziele zurück.
Syntax
HRESULT GetRelations(
[in] BSTR RelationSDEL,
[in] BSTR MatchSDEL,
[out, retval] IWDTFTargets2 **ppRelations
);
Parameter
[in] RelationSDEL
Eine SDEL-Anweisung, die ein oder mehrere Beziehungstoken enthält, die die gewünschten Ziele angeben.
[in] MatchSDEL
Die SDEL-Anweisung, mit der jedes zurückgegebene Ziel übereinstimmen muss. Wenn MatchSDEL- leer ist, werden alle Ziele zurückgegeben.
[out, retval] ppRelations
Die Adresse der Variablen, die das Ergebnis dieser Methode erhält.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.
Bemerkungen
Mit der GetRelations--Methode rufen Sie verwandte Instanzen der IWDTFTarget2--Schnittstelle ab. Sie geben die gewünschten Ziele durch eine Beziehung SDEL--Anweisung an. In der Regel kann eine SDEL-Anweisung Attributtoken, Vergleichsoperatoren und Wertspezifizierer enthalten, um Übereinstimmungen auszuführen. Sie benötigen diese Elemente jedoch nicht im parameter RelationSDEL für die GetRelations--Methode ordnungsgemäß funktionieren (der MatchSDEL Parameter folgt den Regeln für die IWDTFTarget2::Eval Methode).
Die IWDTFTarget2:GetRelations Methode platziert jedes verwandte Ziel, das GetRelations von der RelationSDEL-Anweisung in einer neuen Auflistung findet.
GetRelations- gibt nur die Teilmenge der Ziele zurück, die die MatchSDEL Parametereinschränkungen erfüllen. Wenn die MatchSDEL Parameterzeichenfolge leer ist, gibt GetRelations die gesamte Auflistung von Zielen zurück. Dieser Vorgang filtert alle Ziele heraus, die VARIANT_FALSE zurückgeben, wenn Sie MatchSDEL- für die IWDTFTarget2::Eval-Methode des Ziels bereitstellen.
Weitere Informationen zur Verwendung der GetRelations--Methode finden Sie unter Simple Data Evaluation Language Overview.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP Professional |
| mindestens unterstützte Server- | Windows Server 2008 |
| Zielplattform- | Desktop |
| Header- | wdtf.h |