Funzione VariantToDoubleWithDefault (propvarutil.h)
Estrae un valore DOUBLE da una struttura VARIANT . Se non esiste alcun valore, viene restituito il valore predefinito specificato.
Sintassi
PSSTDAPI_(DOUBLE) VariantToDoubleWithDefault(
[in] REFVARIANT varIn,
[in] DOUBLE dblDefault
);
Parametri
[in] varIn
Tipo: REFVARIANT
Riferimento a una struttura VARIANT di origine.
[in] dblDefault
Tipo: DOUBLE
Valore predefinito da utilizzare in cui non esiste alcun valore estraibile.
Valore restituito
Tipo: DOUBLE
Restituisce il valore double estratto; in caso contrario, il valore predefinito specificato in dblDefault.
Commenti
Questa funzione helper viene usata quando l'applicazione chiamante prevede che un valore VARIANT contenga un valore DOUBLE e voglia usare un valore predefinito, se non lo è.
Se l'origine VARIANT è di tipo VT_R8, questo helper estrae il valore DOUBLE .
Se l'origine VARIANT non è di tipo VT_R8, la funzione tenta di convertire il valore in VARIANTin double.
Se l'origine VARIANT è di tipo VT_EMPTY o non è possibile eseguire una conversione, VariantToDoubleWithDefault restituisce il valore predefinito fornito da dblDefault. Per un elenco delle conversioni possibili, vedere PropVariantChangeType .
Esempio
Nell'esempio seguente, da includere come parte di un programma più ampio, viene illustrato come usare VariantToDoubleWithDefault per accedere a un valore DOUBLE archiviato in una struttura 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.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows XP con SP2, Windows Vista [solo app desktop] |
Server minimo supportato | Windows Server 2003 con SP1 [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | propvarutil.h |
Libreria | Propsys.lib |
DLL | Propsys.dll (versione 6.0 o successiva) |
Componente ridistribuibile | Windows Desktop Search (WDS) 3.0 |