SystemTimeToFileTime, fonction (timezoneapi.h)

Article
03/04/2024

Convertit une heure système au format d’heure de fichier. L’heure système est basée sur le temps universel coordonné (UTC).

Syntaxe

BOOL SystemTimeToFileTime(
  [in]  const SYSTEMTIME *lpSystemTime,
  [out] LPFILETIME       lpFileTime
);

Paramètres

[in] lpSystemTime

Pointeur vers une structure SYSTEMTIME qui contient l’heure système à convertir de l’heure UTC au format heure du fichier.

Le membre wDayOfWeek de la structure SYSTEMTIME est ignoré.

[out] lpFileTime

Pointeur vers une structure FILETIME pour recevoir l’heure système convertie.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Notes

Une valeur de retour False peut indiquer que la structure SYSTEMTIME passée représente une date non valide. Certaines situations, telles que le jour supplémentaire ajouté dans une année bissextile, peuvent entraîner la création inattendue d’une date non valide par la logique d’application. Pour plus d’informations sur l’évitement de ces problèmes, consultez Préparation à l’année bissextile.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	timezoneapi.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll