PropVariantToDoubleWithDefault-Funktion (propvarutil.h)
Extrahiert einen Double-Eigenschaftswert einer PROPVARIANT-Struktur . Wenn kein Wert vorhanden ist, wird der angegebene Standardwert zurückgegeben.
Syntax
PSSTDAPI_(DOUBLE) PropVariantToDoubleWithDefault(
[in] REFPROPVARIANT propvarIn,
[in] DOUBLE dblDefault
);
Parameter
[in] propvarIn
Typ: REFPROPVARIANT
Verweis auf eine PROPVARIANT-Quellstruktur .
[in] dblDefault
Typ: DOUBLE
Gibt den Standardeigenschaftswert für die Verwendung an, wenn derzeit kein Wert vorhanden ist.
Rückgabewert
Typ: DOUBLE
Gibt den extrahierten doppelten Wert oder den Standardwert zurück.
Hinweise
Diese Hilfsfunktion wird an Stellen verwendet, an denen die aufrufende Anwendung erwartet, dass eine PROPVARIANT einen doppelten Wert enthält, und wenn dies nicht der Fall ist, einen Standardwert verwenden möchte. Für instance kann eine Anwendung, die Werte aus einem Eigenschaftenspeicher erhält, dies verwenden, um den double-Wert für double-Eigenschaften sicher zu extrahieren.
Wenn die PROPVARIANT-Quelleden Typ VT_R8 hat, extrahiert diese Hilfsfunktion den double-Wert. Andernfalls wird versucht, den Wert in der PROPVARIANT-Struktur in ein Double zu konvertieren. Wenn der PropVARIANT-QuelltypVT_EMPTY hat oder eine Konvertierung nicht möglich ist, gibt PropVariantToDoubleWithDefault den von dblDefault bereitgestellten Standardwert zurück. Eine Liste der möglichen Konvertierungen finden Sie unter PropVariantChangeType .
Beispiele
// IPropertyStore *ppropstore;
// Assume variable ppropstore is initialized and valid
PROPVARIANT propvar = {0};
HRESULT hr = ppropstore->GetValue(PKEY_Image_HorizontalResolution, &propvar);
if (SUCCEEDED(hr))
{
// PKEY_Image_HorizontalResolution is expected to produce a VT_R8 or VT_EMPTY value.
// The application developer decided to treat VT_EMPTY or invalid values as 72.0
DOUBLE dblResolution = PropVariantToDoubleWithDefault(propvar, 72.0);
// dblResolution is now valid.
PropVariantClear(&propvar);
}
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 |