IWDTFTarget2 ::GetValue, méthode (wdtf.h)
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 automation.
Valeur de retour
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un HRESULT code d’erreur.
Remarques
Vous spécifiez le champ que la méthode getValue récupère à l’aide d’une instruction SDEL standard. En règle générale, une instruction SDEL peut contenir des opérateurs de comparaison et des spécificateurs de valeurs 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 (nonVT_EMPTY) VARIANT. Si une seule valeur est trouvée, cette 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 OU autorise la collection de la première valeur trouvée (à partir de la gauche).
Pour plus d’informations sur l’utilisation de GetValue, consultez Vue d’ensemble du langage d’évaluation des données simple.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP Professionnel |
| serveur minimum pris en charge | Windows Server 2008 |
| plateforme cible | Bureau |
| d’en-tête | wdtf.h |