Méthode IWDTFTarget2 ::GetValue (wdtf.h)

  • Article

Retourne une valeur de la cible associée à un attribut spécifié.

Syntaxe

HRESULT GetValue(
  [in]          BSTR    SDEL,
  [out, retval] VARIANT *pValue
);

Paramètres

[in] SDEL

Instruction SDEL qui spécifie la valeur d’attribut à récupérer.

[out, retval] pValue

Adresse d’une variable qui reçoit le résultat de cette méthode. Le résultat peut être n’importe quel VARIANT compatible avec l’automatisation.

Valeur retournée

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Vous spécifiez le champ que la méthode GetValue récupère à l’aide d’une instruction SDEL normale. En règle générale, une instruction SDEL peut contenir des opérateurs de comparaison et des spécificateurs de valeur pour effectuer des correspondances. Toutefois, vous n’avez pas besoin de ces éléments pour que GetValue fonctionne correctement.

Pour chaque champ spécifié dans l’instruction SDEL (y compris l’itération sur un ensemble de relations), cette méthode collecte un ensemble de valeurs VARIANT (non VT_EMPTY). Si une seule valeur est trouvée, cette valeur VARIANT est retournée. Si plusieurs valeurs sont trouvées, les valeurs sont empaquetées dans un VARIANT qui contient un SAFEARRAY. Si aucune valeur n’est trouvée, la méthode retourne un VARIANT qui contient VT_EMPTY.

En outre, l’opérateur AND autorise la collecte des valeurs des deux côtés de lui-même, mais OR autorise uniquement la collecte de la première valeur trouvée (en commençant par la gauche).

Pour plus d’informations sur l’utilisation de GetValue, consultez Vue d’ensemble du langage d’évaluation des données simple.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP Professionnel
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Desktop (Expérience utilisateur)
En-tête wdtf.h

Voir aussi

IWDTFTarget2