Funzione PropVariantToFileTimeVectorAlloc (propvarutil.h)

Articolo
03/01/2024

Estrae i dati da una struttura PROPVARIANT in un vettore FILETIME appena allocato.

Sintassi

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

Parametri

[in] propvar

Tipo: REFPROPVARIANT

Riferimento a una struttura PROPVARIANT di origine.

[out] pprgft

Tipo: FILETIME**

Quando questa funzione restituisce, contiene un puntatore a un vettore di valori FILETIME estratti dalla struttura PROPVARIANT di origine.

[out] pcElem

Tipo: ULONG*

Quando questa funzione restituisce, contiene il conteggio degli elementi FILETIME estratti dalla struttura PROPVARIANT di origine.

Valore restituito

Tipo: HRESULT

Restituisce uno dei valori seguenti.

Codice restituito	Descrizione
S_OK	Restituisce S_OK se ha esito positivo o un valore di errore in caso contrario.
E_INVALIDARG	PropVARIANT non era del tipo appropriato.

Commenti

Questa funzione helper viene usata nelle posizioni in cui l'applicazione chiamante prevede che un valore vettore FILETIME contenga un valore vettore FILETIME.

Se l'origine PROPVARIANT ha tipo VT_VECTOR | VT_FILETIME, questa funzione estrae un vettore di valori FILETIMEs in un vettore appena allocato di valori FILETIME. L'applicazione chiamante è responsabile dell'uso di CoTaskMemFree per rilasciare il vettore puntato da pprgft quando non è più necessario.

I FILETIMes di output useranno lo stesso fuso orario dei FILETIMEs di origine.

Esempio

L'esempio seguente, da includere come parte di un programma più ampio, illustra come usare PropVariantToFileTimeVectorAlloc per accedere a un valore vettore FILETIME in 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);
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2, Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	propvarutil.h
Libreria	Propsys.lib
DLL	Propsys.dll (versione 6.0 o successiva)
Componente ridistribuibile	Windows Desktop Search (WDS) 3.0

Vedi anche

InitPropVariantFromFileTimeVector

PropVariantToFileTime

PropVariantToFileTimeVector

Condividi tramite