Función PropVariantToFileTimeVectorAlloc (propvarutil.h)

Extrae datos de una estructura PROPVARIANT en un vector FILETIME recién asignado.

Sintaxis

PSSTDAPI PropVariantToFileTimeVectorAlloc(
  [in]  REFPROPVARIANT propvar,
  [out] FILETIME       **pprgft,
  [out] ULONG          *pcElem
);

Parámetros

[in] propvar

Tipo: REFPROPVARIANT

Referencia a una estructura PROPVARIANT de origen.

[out] pprgft

Tipo: FILETIME**

Cuando esta función vuelve, contiene un puntero a un vector de valores FILETIME extraídos de la estructura PROPVARIANT de origen.

[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.
E_INVALIDARG	ElPROPVARIANT 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.

Si el PROPVARIANT de origen tiene VT_VECTOR de tipo | VT_FILETIME, esta función extrae un vector de valores FILETIMEs en un vector recién asignado de valores FILETIME. La aplicación que realiza la llamada es responsable de usar CoTaskMemFree para liberar el vector al que apunta pprgft cuando ya no es necesario.

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 mayor, se muestra cómo usar PropVariantToFileTimeVectorAlloc para tener acceso a un valor de vector FILETIME en un PROPVARIANT.

// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid. 
// The application is expecting propvar to contain a vector of FILETIME values.
BOOL *prgTimes;
ULONG cTimes;
HRESULT hr = PropVariantToBooleanVectorAlloc(propvar, &prgTimes, &cTimes);
if (SUCCEEDED(hr))
{
     // prgTimes now points to a vector of cTimes file times.
     CoTaskMemFree(prgTimes);
}

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

PropVariantToFileTimeVector