Fonction PropVariantToFileTimeVectorAlloc (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 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 |
|---|---|
|
Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire. |
|
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 |