IWDTFTarget2::GetValue-Methode (wdtf.h)
Gibt einen Wert aus dem Ziel zurück, der einem angegebenen Attribut zugeordnet ist.
Syntax
HRESULT GetValue(
[in] BSTR SDEL,
[out, retval] VARIANT *pValue
);
Parameter
[in] SDEL
Eine SDEL-Anweisung, die den abzurufenden Attributwert angibt.
[out, retval] pValue
Die Adresse einer Variablen, die das Ergebnis dieser Methode empfängt. Das Ergebnis kann ein beliebiger automatisierungskompatibler VARIANT sein.
Rückgabewert
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Sie geben das Feld an, das die GetValue-Methode mithilfe einer regulären SDEL-Anweisung abruft. In der Regel kann eine SDEL-Anweisung Vergleichsoperatoren und Wertspezifizierer zum Ausführen von Übereinstimmungen enthalten. Sie benötigen diese Elemente jedoch nicht, damit GetValue ordnungsgemäß funktioniert.
Für jedes Feld, das in der SDEL-Anweisung angegeben wird (einschließlich der Iterierung über einen Satz von Beziehungen), sammelt diese Methode einen Satz von VARIANT-Werten (nicht VT_EMPTY). Wenn nur ein Wert gefunden wird, wird dieser VARIANT zurückgegeben. Wenn mehrere Werte gefunden werden, werden die Werte in einen VARIANT-Wert verpackt, der ein SAFEARRAY enthält. Wenn keine Werte gefunden werden, gibt die Methode einen VARIANT-Wert zurück, der VT_EMPTY enthält.
Darüber hinaus lässt der AND-Operator die Sammlung der Werte auf beiden Seiten zu, aber OR lässt nur die Sammlung des ersten gefundenen Werts zu (beginnend mit der linken Seite).
Weitere Informationen zur Verwendung von GetValue 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 |