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 mindestens ein 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 empfängt.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Sie verwenden die GetRelations-Methode , um verwandte Instanzen der IWDTFTarget2-Schnittstelle abzurufen. Sie geben die gewünschten Ziele durch eine SDEL-Anweisung für Relationen an. In der Regel kann eine SDEL-Anweisung Attributtoken, Vergleichsoperatoren und Wertspezifizierer enthalten, um Übereinstimmungen durchzuführen. Sie benötigen diese Elemente jedoch nicht im Parameter RelationSDEL , damit die GetRelations-Methode ordnungsgemäß funktioniert (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 findet, in einer neuen Auflistung.
GetRelations gibt nur die Teilmenge von Zielen 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 Prozess 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 Übersicht über die Sprache für die Einfache Datenauswertung.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP Professional |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Desktop |
| Kopfzeile | wdtf.h |