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

Weitere Informationen

InitPropVariantFromInt16

PropVariantChangeType

PropVariantToInt16

VariantToInt16