PropVariantToFileTimeVectorAlloc, fonction (propvarutil.h)

Extrait les données d’une structure PROPVARIANT dans un vecteur FILETIME nouvellement alloué.

Syntaxe

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

Paramètres

[in] propvar

Type : REFPROPVARIANT

Référence à une structure PROPVARIANT source.

[out] pprgft

Type : FILETIME**

Lorsque cette fonction est retournée, contient un pointeur vers un vecteur de valeurs FILETIME extraites de la structure PROPVARIANT source.

[out] pcElem

Type : ULONG*

Lorsque cette fonction est retournée, contient le nombre d’éléments FILETIME extraits de la structure PROPVARIANT source.

Valeur retournée

Type : HRESULT

Retourne l’une des valeurs suivantes.

Code de retour Description
S_OK
Retourne S_OK si elle réussit ou une valeur d’erreur sinon.
E_INVALIDARG
Le PROPVARIANT n’était pas du type approprié.

Notes

Cette fonction d’assistance est utilisée dans des endroits où l’application appelante attend un PROPVARIANT pour contenir une valeur vectorielle FILETIME.

Si la source PROPVARIANT a le type VT_VECTOR | VT_FILETIME, cette fonction extrait un vecteur de valeurs FILETIMEs dans un vecteur nouvellement alloué de valeurs FILETIME. L’application appelante est chargée d’utiliser CoTaskMemFree pour libérer le vecteur pointé par pprgft lorsqu’il n’est plus nécessaire.

Les FILETIMEs de sortie utilisent le même fuseau horaire que les FILETIMEs sources.

Exemples

L’exemple suivant, à inclure dans le cadre d’un programme plus grand, montre comment utiliser PropVariantToFileTimeVectorAlloc pour accéder à une valeur de vecteur FILETIME dans 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);
}

Configuration requise

   
Client minimal pris en charge Windows XP avec SP2, Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible Windows
En-tête propvarutil.h
Bibliothèque Propsys.lib
DLL Propsys.dll (version 6.0 ou ultérieure)
Composant redistribuable Windows Desktop Search (WDS) 3.0

Voir aussi

InitPropVariantFromFileTimeVector

PropVariantToFileTime

PropVariantToFileTimeVector