Fonction VariantToDosDateTime (propvarutil.h)
Extrait une valeur de date et d’heure au format Microsoft MS-DOS à partir d’une structure VARIANT .
Syntaxe
PSSTDAPI VariantToDosDateTime(
[in] REFVARIANT varIn,
[out] WORD *pwDate,
[out] WORD *pwTime
);
Paramètres
[in] varIn
Type : REFVARIANT
Référence à une structure VARIANT source.
[out] pwDate
Type : WORD*
Lorsque cette fonction retourne, contient le MOT extrait qui représente une date MS-DOS.
[out] pwTime
Type : WORD*
Lorsque cette fonction retourne, contient l’extrait contient le MOT extrait qui représente une heure MS-DOS.
Valeur retournée
Type : HRESULT
Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Cette fonction d’assistance est utilisée lorsque l’application appelante s’attend à ce qu’un VARIANT contienne une valeur datetime.
Si le VARIANT source est de type VT_DATE, cette fonction extrait la valeur datetime.
Si le VARIANT source n’est pas de type VT_DATE, la fonction tente de convertir la valeur de la structure VARIANT dans le format approprié. Si une conversion n’est pas possible, VariantToDosDateTime retourne un code d’échec. Pour obtenir la liste des conversions possibles, consultez PropVariantChangeType .
Pour plus d’informations sur les formats de pwDate, pwTime et la valeur datetime source, consultez DosDateToVariantTime.
Exemples
L’exemple suivant, à inclure dans un programme plus grand, montre comment utiliser VariantToDosDateTime pour accéder à une valeur datetime dans un VARIANT.
// VARIANT var;
// Assume variable var is initialize and valid.
// The application expects var to hold a VT_DATE value.
WORD wDate;
WORD wTime;
HRESULT hr = VariantToDosDateTime(var, &wDate, &wTime);
if (SUCCEEDED(hr))
{
// wDate and wTime are now valid.
}
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 |