Fonction PropVariantToFileTimeVectorAlloc (propvarutil.h)

  • Article

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 retourne, contient un pointeur vers un vecteur de valeurs FILETIME extraites de la structure PROPVARIANT source.

[out] pcElem

Type : ULONG*

Lorsque cette fonction retourne, 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 en cas de réussite, ou une valeur d’erreur dans le cas contraire.
E_INVALIDARG
 LEPROPVARIANT n’était pas du type approprié.

Remarques

Cette fonction d’assistance est utilisée dans les endroits où l’application appelante s’attend à ce qu’un PROPVARIANT contienne une valeur de vecteur 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 responsable de l’utilisation de 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 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

Condition requise Valeur
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