Funzione PropVariantToInt64WithDefault (propvarutil.h)
Estrae il valore della proprietà Int64 di una struttura PROPVARIANT . Se non esiste alcun valore, viene restituito il valore predefinito specificato.
Sintassi
PSSTDAPI_(LONGLONG) PropVariantToInt64WithDefault(
[in] REFPROPVARIANT propvarIn,
[in] LONGLONG llDefault
);
Parametri
[in] propvarIn
Tipo: REFPROPVARIANT
Riferimento a una struttura PROPVARIANT di origine.
[in] llDefault
Tipo: LONGLONG
Specifica un valore di proprietà predefinito, per l'uso in cui non esiste alcun valore.
Valore restituito
Tipo: LONGLONG
Restituisce il valore LONGLONG estratto o il valore predefinito.
Commenti
Questa funzione helper viene usata nelle posizioni in cui l'applicazione chiamante prevede un valore PROPVARIANT per contenere un valore LONGLONG e vuole usare un valore predefinito se non lo fa. Ad esempio, un'applicazione che ottiene valori da un archivio proprietà può usare questa opzione 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 un LONGLONG. Se l'origine PROPVARIANT ha tipo VT_EMPTY o una conversione non è possibile, PropVariantToInt64WithDefault restituirà il valore predefinito fornito da llDefault. Per un elenco di possibili conversioni, vedere PropVariantChangeType .
Esempio
L'esempio seguente, da includere come parte di un programma più grande, illustra come usare PropVariantToInt64WithDefault per accedere a un valore LONGLONG in un PROPVARIANT.
// 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
Requisiti
| 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 |