Compartir a través de

Función PropVariantToInt64 (propvarutil.h)

  • Artículo

Extrae un valor LONGLONG de una estructura PROPVARIANT . Si no se puede extraer ningún valor, se asigna un valor predeterminado.

Sintaxis

PSSTDAPI PropVariantToInt64(
  [in]  REFPROPVARIANT propvarIn,
  [out] LONGLONG       *pllRet
);

Parámetros

[in] propvarIn

Tipo: REFPROPVARIANT

Referencia a una estructura PROPVARIANT de origen.

[out] pllRet

Tipo: LONGLONG*

Cuando se devuelve esta función, contiene el valor de propiedad extraído si existe uno; de lo contrario, 0.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

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 . 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 no es posible una conversión, PropVariantToInt64 devolverá un código de error y establecerá pllRet en 0. Consulte PropVariantChangeType para obtener una lista de las posibles conversiones. Tenga en cuenta que VT_EMPTY se convierte correctamente en 0.

Ejemplos

// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid
LONGLONG llValue; // The application is expecting propvar to hold a VT_I8 value
HRESULT hr = PropVariantToInt64(propvar, &llValue);
if (SUCCEEDED(hr))
{
     // llValue is valid
}                    
else
{
         // the extraction failed
}

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

Consulte también

InitPropVariantFromInt64

PropVariantChangeType

PropVariantToInt64Vector

VariantToInt64