Partager via


SystemTimeToFileTime, fonction (timezoneapi.h)

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

Voir aussi

DosDateTimeToFileTime

FILETIME

FileTimeToDosDateTime

FileTimeToSystemTime

SYSTEMTIME

Temps système

Fonctions de temps