Méthode SWbemDateTime.GetFileTime

La méthode GetFileTime de l’objet SWbemDateTime convertit une valeur de date et d’heure au format CIM DATETIME au format FILETIME.

Si le paramètre est défini sur TRUE, la valeur de retour représente une heure locale pour le client. Sinon, la valeur de retour est une heure UTC (Coordinated Universal Time). Une structure FILETIMEDATETIME est une valeur de 64 bits qui représente le nombre d'unités de 100 nanosecondes depuis le début du 1er janvier 1601. Windows Management Instrumentation (WMI) traite les valeurs FILETIME comme des représentations sous forme de chaînes de nombres 64 bits non signés.

Pour obtenir une explication de cette syntaxe, voir Conventions de document pour l’API de script.

Syntaxe

vDate = .GetFileTime( _
  [ ByVal bIsLocaL ] _
)

Paramètres

bIsLocaL [in, facultatif]

Indique si la valeur retournée est interprétée comme une heure locale. La propriété UTC contient alors l'heure locale convertie en temps universel coordonné (UTC). Si la valeur est FALSE, la valeur est interprétée comme UTC avec un décalage égal à zéro (0).

Valeur retournée

Date et heure au format FILETIME.

Codes d’erreur

Au terme de l’exécution de la méthode GetFileTime, l’objet Err peut contenir un code d’erreur de la liste suivante.

wbemErrFailed - 2147749889 (0x80041001)

L'appel a échoué.

Notes

Les valeurs VT_DATE et FILETIME ne peuvent pas contenir de champs génériques.

La méthode GetFileTime échoue (wbemErrFailed) si l’une des propriétés suivantes est FALSE :

• YearSpecified
• MonthSpecified
• DaySpecified
• HoursSpecified
• MinutesSpecified
• SecondsSpecified
• MicrosecondsSpecified
• UTCSpecified

En cas de retour réussi de SetFileTime, toutes ces propriétés sont définies sur TRUE.

Exemples

Pour obtenir des exemples d’utilisation de l’objet SWbemDateTime pour convertir des valeurs CIM DATETIME au format FILETIME ou VT_DATE, et inversement, consultez Tâches WMI : dates et heures. Pour obtenir une description du format CIM DATETIME, consultez Format de date et d’heure.

Spécifications

Voir aussi

SWbemDateTime.GetVarDate

SWbemDateTime

DATETIME