PropVariantToFileTimeVector, fonction (propvarutil.h)
Extrait des données d’une structure PROPVARIANT dans un vecteur FILETIME.
Syntaxe
PSSTDAPI PropVariantToFileTimeVector(
[in] REFPROPVARIANT propvar,
[out] FILETIME *prgft,
[in] ULONG crgft,
[out] ULONG *pcElem
);
Paramètres
[in] propvar
Type : REFPROPVARIANT
Référence à une structure PROPVARIANT source.
[out] prgft
Type : FILETIME*
Pointe vers une mémoire tampon contenant des valeurs FILETIME crgft . Lorsque cette fonction est retournée, la mémoire tampon a été initialisée avec les éléments FILETIME pcElem extraits de la structure PROPVARIANT source.
[in] crgft
Type : ULONG
Taille dans les éléments de la mémoire tampon pointée par prgft.
[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 dans le cas contraire. |
|
La propriété PROPVARIANT source contenait plus que les valeurs crgn. Mémoire tampon pointée par prgft. |
|
La PROPVARIANT n’était pas du type approprié. |
Remarques
Cette fonction d’assistance est utilisée dans les emplacements où l’application appelante s’attend à ce qu’un PROPVARIANT contienne une valeur vectorielle filetime avec un nombre fixe d’éléments.
Si la propriété PROPVARIANT source a le type VT_VECTOR | VT_FILETIME, cette fonction d’assistance extrait jusqu’à crgft les valeurs FILETIME et les place dans la mémoire tampon pointée par prgft. Si la PROPVARIANT contient plus d’éléments que cela ne correspondra pas à la mémoire tampon prgft , cette fonction retourne une erreur et définit pcElem sur 0.
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 PropVariantToFileTimeVector pour accéder à une valeur de vecteur FILETIME dans un PROPVARIANT.
// PROPVARIANT propvar;
// Assume the variable propvar is initialized and valid
FILETIME rgTimes[4]; // The application is expecting propvar to hold 4 FILETIMEs in a vector
ULONG cTimes;
HRESULT hr = PropVariantToFileTimeVector(propvar, rgTime, ARRAYSIZE(rgTime), &cTimes);
if (SUCCEEDED(hr))
{
if (cTimes == ARRAYSIZE(rgTime))
{
// The application got 4 FILETIMEs which are now stored in rgTime
}
else
{
// The application got cTimes which are stored in the first cTimes elements of rgTime
}
}
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 |