Funzione PropVariantToInt64 (propvarutil.h)

Articolo
03/15/2023

Estrae un valore LONGLONG da una struttura PROPVARIANT . Se non è possibile estrarre alcun valore, viene assegnato un valore predefinito.

Sintassi

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

Parametri

[in] propvarIn

Tipo: REFPROPVARIANT

Riferimento a una struttura PROPVARIANT di origine.

[out] pllRet

Tipo: LONGLONG*

Quando questa funzione viene restituita, contiene il valore della proprietà estratta, se presente; in caso contrario, 0.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Questa funzione helper viene usata in posizioni in cui l'applicazione chiamante prevede che un VALORE PROPVARIANT contenga un valore LONGLONG . Ad esempio, un'applicazione che ottiene valori da un archivio proprietà può usarla per estrarre in modo sicuro il valore LONGLONG per le proprietà Int64.

Se l'origine PROPVARIANT ha tipo VT_I8, questa funzione helper estrae il valore LONGLONG . In caso contrario, tenta di convertire il valore nella struttura PROPVARIANT in longlong. Se una conversione non è possibile, PropVariantToInt64 restituirà un codice di errore e imposterà pllRet su 0. Per un elenco delle conversioni possibili, vedere PropVariantChangeType . Si noti che VT_EMPTY viene convertito correttamente in 0.

Esempio

// 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
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2, Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	propvarutil.h
Libreria	Propsys.lib
DLL	Propsys.dll (versione 6.0 o successiva)
Componente ridistribuibile	Windows Desktop Search (WDS) 3.0