Auf Englisch lesen

Freigeben über


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

Weitere Informationen

IWDTFTarget2