Función PropVariantToInt16WithDefault (propvarutil.h)
Extrae el valor de la propiedad Int16 de una estructura PROPVARIANT . Si no existe ningún valor actualmente, se devuelve el valor predeterminado especificado.
Sintaxis
PSSTDAPI_(SHORT) PropVariantToInt16WithDefault(
[in] REFPROPVARIANT propvarIn,
[in] SHORT iDefault
);
Parámetros
[in] propvarIn
Tipo: REFPROPVARIANT
Referencia a una estructura PROPVARIANT de origen.
[in] iDefault
Tipo: SHORT
Especifica el valor de propiedad predeterminado, para su uso cuando no existe ningún valor actualmente.
Valor devuelto
Tipo: SHORT
Devuelve el valor corto extraído o el valor predeterminado.
Comentarios
Esta función auxiliar se usa en lugares donde la aplicación que realiza la llamada espera que un PROPVARIANT contenga un valor Int16 y quiera usar un valor predeterminado si no lo hace. Por ejemplo, una aplicación que obtiene valores de un almacén de propiedades puede usarla para extraer de forma segura el valor SHORT de las propiedades Int16 .
Si el PROPVARIANT de origen tiene el tipo VT_I2, esta función auxiliar extrae el valor Int16 . De lo contrario, intenta convertir el valor de la estructura PROPVARIANT en un SHORT. Si el PROPVARIANT de origen tiene el tipo VT_EMPTY o una conversión no es posible, PropVariantToInt16WithDefault devolverá el valor predeterminado proporcionado por iDefault. Consulte PropVariantChangeType para obtener una lista de las posibles conversiones.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP con SP2, Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 con SP1 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | propvarutil.h |
| Library | Propsys.lib |
| Archivo DLL | Propsys.dll (versión 6.0 o posterior) |
| Redistribuible | Windows Desktop Search (WDS) 3.0 |