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

Weitere Informationen

InitPropVariantFromInt64

PropVariantChangeType

PropVariantToInt64

VariantToInt64