Fonction VariantToDosDateTime (propvarutil.h)

Article
03/04/2024

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