Función PropVariantToInt64WithDefault (propvarutil.h)
Extrae el valor de la propiedad Int64 de una estructura PROPVARIANT . Si no existe ningún valor, se devuelve el valor predeterminado especificado.
Sintaxis
PSSTDAPI_(LONGLONG) PropVariantToInt64WithDefault(
[in] REFPROPVARIANT propvarIn,
[in] LONGLONG llDefault
);
Parámetros
[in] propvarIn
Tipo: REFPROPVARIANT
Referencia a una estructura PROPVARIANT de origen.
[in] llDefault
Tipo: LONGLONG
Especifica un valor de propiedad predeterminado, para su uso cuando no existe ningún valor actualmente.
Valor devuelto
Tipo: LONGLONG
Devuelve el valor LONGLONG 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 LONGLONG 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 de LONGLONG para las propiedades Int64.
Si el PROPVARIANT de origen tiene el tipo VT_I8, esta función auxiliar extrae el valor de LONGLONG . De lo contrario, intenta convertir el valor de la estructura PROPVARIANT en longlong. Si el PROPVARIANT de origen tiene el tipo VT_EMPTY o una conversión no es posible, PropVariantToInt64WithDefault devolverá el valor predeterminado proporcionado por llDefault. Consulte PropVariantChangeType para obtener una lista de las posibles conversiones.
Ejemplos
En el ejemplo siguiente, para incluirse como parte de un programa mayor, se muestra cómo usar PropVariantToInt64WithDefault para tener acceso a un valor LONGLONG en 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
Requisitos
| 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 |