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 |
|---|---|
|
Retourne S_OK si elle réussit ou une valeur d’erreur sinon. |
|
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 |