Funzione PropVariantToInt16WithDefault (propvarutil.h)
Estrae il valore della proprietà Int16 di una struttura PROPVARIANT . Se non esiste alcun valore, viene restituito il valore predefinito specificato.
Sintassi
PSSTDAPI_(SHORT) PropVariantToInt16WithDefault(
[in] REFPROPVARIANT propvarIn,
[in] SHORT iDefault
);
Parametri
[in] propvarIn
Tipo: REFPROPVARIANT
Riferimento a una struttura PROPVARIANT di origine.
[in] iDefault
Tipo: SHORT
Specifica il valore predefinito della proprietà, per l'uso in cui non esiste alcun valore.
Valore restituito
Tipo: SHORT
Restituisce il valore breve estratto o il valore predefinito.
Commenti
Questa funzione helper viene usata nelle posizioni in cui l'applicazione chiamante prevede che un PROPVARIANT contenga un valore Int16 e voglia 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 SHORT per le proprietà Int16 .
Se l'origine PROPVARIANT ha tipo VT_I2, questa funzione helper estrae il valore Int16 . In caso contrario, tenta di convertire il valore nella struttura PROPVARIANT in un short. Se l'origine PROPVARIANT ha tipo VT_EMPTY o una conversione non è possibile, PropVariantToInt16WithDefault restituirà il valore predefinito fornito da iDefault. Per un elenco di possibili conversioni, vedere PropVariantChangeType .
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 |