Compartilhar via

Função PropVariantToFileTimeVectorAlloc (propvarutil.h)

  • Artigo

Extrai dados de uma estrutura PROPVARIANT em um vetor FILETIME recém-alocado.

Sintaxe

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

Parâmetros

[in] propvar

Tipo: REFPROPVARIANT

Referência a uma estrutura PROPVARIANT de origem .

[out] pprgft

Tipo: FILETIME**

Quando essa função retorna, contém um ponteiro para um vetor de valores FILETIME extraídos da estrutura PROPVARIANT de origem.

[out] pcElem

Tipo: ULONG*

Quando essa função retorna, contém a contagem de elementos FILETIME extraídos da estrutura PROPVARIANT de origem.

Retornar valor

Tipo: HRESULT

Retorna um dos valores a seguir.

Código de retorno Descrição
S_OK
 Retorna S_OK se tiver êxito ou um valor de erro, caso contrário.
E_INVALIDARG
 OPROPVARIANT não era do tipo apropriado.

Comentários

Essa função auxiliar é usada em locais em que o aplicativo de chamada espera que um PROPVARIANT mantenha um valor de vetor FILETIME.

Se o PROPVARIANT de origem tiver o tipo VT_VECTOR | VT_FILETIME, essa função extrai um vetor de valores FILETIMEs em um vetor recém-alocado de valores FILETIME. O aplicativo de chamada é responsável por usar CoTaskMemFree para liberar o vetor apontado por pprgft quando ele não for mais necessário.

Os FILETIMEs de saída usarão o mesmo fuso horário que os FILETIMEs de origem.

Exemplos

O exemplo a seguir, a ser incluído como parte de um programa maior, demonstra como usar PropVariantToFileTimeVectorAlloc para acessar um valor de vetor FILETIME em um 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 Valor
Cliente mínimo com suporte Windows XP com SP2, Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho propvarutil.h
Biblioteca Propsys.lib
DLL Propsys.dll (versão 6.0 ou posterior)
Redistribuível Pesquisa da Área de Trabalho do Windows (WDS) 3.0

Confira também

InitPropVariantFromFileTimeVector

PropVariantToFileTime

PropVariantToFileTimeVector