Función PropVariantToFileTimeVector (propvarutil.h)

Extrae datos de una estructura PROPVARIANT en un vector FILETIME.

Sintaxis

PSSTDAPI PropVariantToFileTimeVector(
  [in]  REFPROPVARIANT propvar,
  [out] FILETIME       *prgft,
  [in]  ULONG          crgft,
  [out] ULONG          *pcElem
);

Parámetros

[in] propvar

Tipo: REFPROPVARIANT

Referencia a una estructura PROPVARIANT de origen.

[out] prgft

Tipo: FILETIME*

Apunta a un búfer que contiene valores FILETIME de crgft . Cuando se devuelve esta función, el búfer se ha inicializado con elementos FILETIME pcElem extraídos de la estructura PROPVARIANT de origen.

[in] crgft

Tipo: ULONG

Tamaño en elementos del búfer al que apunta prgft.

[out] pcElem

Tipo: ULONG*

Cuando esta función vuelve, contiene el recuento de elementos FILETIME extraídos de la estructura PROPVARIANT de origen.

Valor devuelto

Tipo: HRESULT

Devuelve uno de los valores siguientes.

Código devuelto	Descripción
S_OK	Devuelve S_OK si se ejecuta correctamente o un valor de error de lo contrario.
TYPE_E_BUFFERTOOSMALL	El PROPVARIANT de origen contenía más de valores crgn. El búfer al que apunta prgft.
E_INVALIDARG	El PROPVARIANT no era del tipo adecuado.

Comentarios

Esta función auxiliar se usa en lugares donde la aplicación que realiza la llamada espera que un PROPVARIANT contenga un valor de vector filetime con un número fijo de elementos.

Si el PROPVARIANT de origen tiene VT_VECTOR de tipo | VT_FILETIME, esta función auxiliar extrae hasta valores filetime de crgft y los coloca en el búfer al que apunta prgft. Si el PROPVARIANT contiene más elementos de los que caben en el búfer prgft , esta función devuelve un error y establece pcElem en 0.

Los FILETIMes de salida usarán la misma zona horaria que filetimes de origen.

Ejemplos

En el ejemplo siguiente, para incluirse como parte de un programa más grande, se muestra cómo usar PropVariantToFileTimeVector para tener acceso a un valor de vector FILETIME en un PROPVARIANT.

// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid
FILETIME rgTimes[4]; // The application is expecting propvar to hold 4 FILETIMEs in a vector
ULONG cTimes;
HRESULT hr = PropVariantToFileTimeVector(propvar, rgTime, ARRAYSIZE(rgTime), &cTimes);
if (SUCCEEDED(hr))
{
     if (cTimes == ARRAYSIZE(rgTime))
     {
         // The application got 4 FILETIMEs which are now stored in rgTime
     }
     else
     {
         // The application got cTimes which are stored in the first cTimes elements of rgTime
     }
}

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

InitPropVariantFromFileTimeVector

PropVariantToFileTime

PropVariantToFileTimeVectorAlloc