VariantToDoubleWithDefault-Funktion (propvarutil.h)
Extrahiert einen DOUBLE-Wert aus einer VARIANT-Struktur . Wenn kein Wert vorhanden ist, wird der angegebene Standardwert zurückgegeben.
Syntax
PSSTDAPI_(DOUBLE) VariantToDoubleWithDefault(
[in] REFVARIANT varIn,
[in] DOUBLE dblDefault
);
Parameter
[in] varIn
Typ: REFVARIANT
Verweis auf eine VARIANT-Quellstruktur .
[in] dblDefault
Typ: DOUBLE
Der Standardwert für die Verwendung, bei der kein extrahierter Wert vorhanden ist.
Rückgabewert
Typ: DOUBLE
Gibt den extrahierten Double-Wert zurück. andernfalls der in dblDefault angegebene Standardwert.
Hinweise
Diese Hilfsfunktion wird verwendet, wenn die aufrufende Anwendung erwartet, dass eine VARIANT einen DOUBLE-Wert enthält und andernfalls einen Standardwert verwenden möchte.
Wenn die VARIANT-Quelle vom Typ VT_R8 ist, extrahiert dieses Hilfsprogramm den DOUBLE-Wert .
Wenn die VARIANT-Quelle nicht vom Typ VT_R8 ist, versucht die Funktion, den Wert im VARIANT-Objekt in einen DOUBLE-Wert zu konvertieren.
Wenn die Variant-Quelle vom Typ VT_EMPTY ist oder eine Konvertierung nicht möglich ist, gibt VariantToDoubleWithDefault den von dblDefault bereitgestellten Standardwert zurück. Eine Liste möglicher Konvertierungen finden Sie unter PropVariantChangeType .
Beispiele
Im folgenden Beispiel, das als Teil eines größeren Programms eingeschlossen werden soll, wird veranschaulicht, wie VariantToDoubleWithDefault verwendet wird, um auf einen DOUBLE-Wert zuzugreifen, der in einer VARIANT-Struktur gespeichert ist.
// 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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP mit SP2, Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 mit SP1 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | propvarutil.h |
| Bibliothek | Propsys.lib |
| DLL | Propsys.dll (Version 6.0 oder höher) |
| Verteilbare Komponente | Windows Desktop Search (WDS) 3.0 |