Partager via


Fonction VariantToDoubleWithDefault (propvarutil.h)

Extrait une valeur DOUBLE d’une structure VARIANT . Si aucune valeur n’existe, la valeur par défaut spécifiée est retournée.

Syntaxe

PSSTDAPI_(DOUBLE) VariantToDoubleWithDefault(
  [in] REFVARIANT varIn,
  [in] DOUBLE     dblDefault
);

Paramètres

[in] varIn

Type : REFVARIANT

Référence à une structure VARIANT source.

[in] dblDefault

Type : DOUBLE

Valeur par défaut pour une utilisation où aucune valeur extractible n’existe.

Valeur retournée

Type : DOUBLE

Retourne la double valeur extraite ; sinon, la valeur par défaut spécifiée dans dblDefault.

Remarques

Cette fonction d’assistance est utilisée lorsque l’application appelante s’attend à ce qu’un VARIANT contienne une valeur DOUBLE et souhaite utiliser une valeur par défaut si ce n’est pas le cas.

Si le VARIANT source est de type VT_R8, cette assistance extrait la valeur DOUBLE .

Si le VARIANT source n’est pas de type VT_R8, la fonction tente de convertir la valeur dans le VARIANT en double.

Si le VARIANT source est de type VT_EMPTY ou si une conversion n’est pas possible, VariantToDoubleWithDefault retourne la valeur par défaut fournie par dblDefault. Pour obtenir la liste des conversions possibles, consultez PropVariantChangeType .

Exemples

L’exemple suivant, à inclure dans un programme plus grand, montre comment utiliser VariantToDoubleWithDefault pour accéder à une valeur DOUBLE stockée dans une structure VARIANT .

// VARIANT var;
// Assume variable var is initialized and valid.
// The application expects var to hold a DOUBLE value.

// The application wants to treat VT_EMPTY as 3.1415.
DOUBLE dblValue = VariantToDoubleWithDefault(var, 3.1415);

// dblValue is now valid.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP avec SP2, Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible Windows
En-tête propvarutil.h
Bibliothèque Propsys.lib
DLL Propsys.dll (version 6.0 ou ultérieure)
Composant redistribuable Windows Desktop Search (WDS) 3.0

Voir aussi

InitVariantFromDouble

PropVariantChangeType

PropVariantToDouble

VariantToDouble