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

Vedi anche

InitPropVariantFromInt16

PropVariantChangeType

PropVariantToInt16

VariantToInt16