PropVariantToInt64WithDefault-Funktion (propvarutil.h)
Extrahiert den Int64-Eigenschaftswert einer PROPVARIANT-Struktur . Wenn kein Wert vorhanden ist, wird der angegebene Standardwert zurückgegeben.
Syntax
PSSTDAPI_(LONGLONG) PropVariantToInt64WithDefault(
[in] REFPROPVARIANT propvarIn,
[in] LONGLONG llDefault
);
Parameter
[in] propvarIn
Typ: REFPROPVARIANT
Verweis auf eine PROPVARIANT-Quellstruktur .
[in] llDefault
Typ: LONGLONG
Gibt einen Standardwert für Die Verwendung an, wenn derzeit kein Wert vorhanden ist.
Rückgabewert
Typ: LONGLONG
Gibt den extrahierten LONGLONG-Wert oder den Standardwert zurück.
Hinweise
Diese Hilfsfunktion wird an Stellen verwendet, an denen die aufrufende Anwendung erwartet, dass eine PROPVARIANT einen LONGLONG-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 bezieht, dies verwenden, um den LONGLONG-Wert für Int64-Eigenschaften sicher zu extrahieren.
Wenn die Propvariant-Quelleden Typ VT_I8 hat, extrahiert diese Hilfsfunktion den LONGLONG-Wert . Andernfalls wird versucht, den Wert in der PROPVARIANT-Struktur in einen LONGLONG-Wert zu konvertieren. Wenn die Propvariant-Quelleden Typ VT_EMPTY aufweist oder eine Konvertierung nicht möglich ist, gibt PropVariantToInt64WithDefault den von llDefault bereitgestellten Standardwert zurück. Eine Liste möglicher Konvertierungen finden Sie unter PropVariantChangeType .
Beispiele
Im folgenden Beispiel wird veranschaulicht, wie PropVariantToInt64WithDefault verwendet wird, um auf einen LONGLONG-Wert in einem PROPVARIANT zuzugreifen.
// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid
// The application is expecting propvar to hold a VT_I8 value, but wishes to treat VT_EMPTY as -1.
LONGLONG llValue = PropVariantToInt64WithDefault(propvar, -1);
// llValue is valid
Anforderungen
| 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 |