PropVariantToInt64-Funktion (propvarutil.h)

Extrahiert einen LONGLONG-Wert aus einer PROPVARIANT-Struktur . Wenn kein Wert extrahiert werden kann, wird ein Standardwert zugewiesen.

Syntax

PSSTDAPI PropVariantToInt64(
  [in]  REFPROPVARIANT propvarIn,
  [out] LONGLONG       *pllRet
);

Parameter

[in] propvarIn

Typ: REFPROPVARIANT

Verweis auf eine PROPVARIANT-Quellstruktur .

[out] pllRet

Typ: LONGLONG*

Wenn diese Funktion zurückgibt, enthält den extrahierten Eigenschaftswert, sofern vorhanden; andernfalls 0.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Hilfsfunktion wird an Stellen verwendet, an denen die aufrufende Anwendung erwartet, dass eine PROPVARIANT einen LONGLONG-Wert enthält. Für instance kann eine Anwendung, die Werte aus einem Eigenschaftenspeicher erhält, 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 eine Konvertierung nicht möglich ist, gibt PropVariantToInt64 einen Fehlercode zurück und legt pllRet auf 0 fest. Eine Liste der möglichen Konvertierungen finden Sie unter PropVariantChangeType . Beachten Sie, dass VT_EMPTY erfolgreich in 0 konvertiert wurde.

Beispiele

// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid
LONGLONG llValue; // The application is expecting propvar to hold a VT_I8 value
HRESULT hr = PropVariantToInt64(propvar, &llValue);
if (SUCCEEDED(hr))
{
     // llValue is valid
}                    
else
{
         // the extraction failed
}

Anforderungen

Weitere Informationen

InitPropVariantFromInt64

PropVariantChangeType

PropVariantToInt64Vector

VariantToInt64