PropVariantToInt16WithDefault-Funktion (propvarutil.h)
Extrahiert den Int16-Eigenschaftswert einer PROPVARIANT-Struktur . Wenn derzeit kein Wert vorhanden ist, wird der angegebene Standardwert zurückgegeben.
Syntax
PSSTDAPI_(SHORT) PropVariantToInt16WithDefault(
[in] REFPROPVARIANT propvarIn,
[in] SHORT iDefault
);
Parameter
[in] propvarIn
Typ: REFPROPVARIANT
Verweis auf eine PROPVARIANT-Quellstruktur .
[in] iDefault
Typ: SHORT
Gibt den Standardeigenschaftswert für die Verwendung an, wenn derzeit kein Wert vorhanden ist.
Rückgabewert
Typ: SHORT
Gibt den extrahierten Short-Wert oder den Standardwert zurück.
Hinweise
Diese Hilfsfunktion wird an Stellen verwendet, an denen die aufrufende Anwendung erwartet, dass eine PROPVARIANT einen Int16-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 SHORT-Wert für Int16-Eigenschaften sicher zu extrahieren.
Wenn die PROPVARIANT-Quelleden Typ VT_I2 hat, extrahiert diese Hilfsfunktion den Int16-Wert . Andernfalls wird versucht, den Wert in der PROPVARIANT-Struktur in einen SHORT-Wert zu konvertieren. Wenn der PropVARIANT-QuelltypVT_EMPTY hat oder eine Konvertierung nicht möglich ist, gibt PropVariantToInt16WithDefault den von iDefault bereitgestellten Standardwert zurück. Eine Liste der möglichen Konvertierungen finden Sie unter PropVariantChangeType .
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 |