Méthode SWbemDateTime. GetFileTime
La méthode GetFileTime de l’objet SWbemDateTime convertit une valeur de date et d’heure dans le format DateTime CIM au format FILETIME.
Si le paramètre est défini sur true, la valeur de retour représente une heure locale pour le client. Dans le cas contraire, la valeur de retour est une heure UTC (Coordinated Universal Time). Une structure DateTime fileTime est une valeur 64 bits qui représente le nombre d’unités de 100 nanosecondes depuis le début du 1er janvier 1601. Windows WMI (Management Instrumentation) traite les valeurs fileTime comme des représentations sous forme de chaîne de nombres 64 bits non signés.
Pour une explication de cette syntaxe, consultez conventions de document pour l’API de script.
Syntaxe
vDate = .GetFileTime( _
[ ByVal bIsLocaL ] _
)
Paramètres
-
bIsLocaL [ dans, facultatif]
-
Indique si la valeur retournée est interprétée comme heure locale. La propriété UTC contient ensuite l’heure locale convertie en décalage UTC (temps universel coordonné) correct. Si la valeur est false, la valeur est interprétée comme étant UTC avec un décalage de zéro (0).
Valeur retournée
Date et heure au format fileTime .
Codes d’erreur
À la fin de la méthode GetFileTime , l’objet Err peut contenir le code d’erreur figurant dans la liste suivante.
-
wbemErrFailed -2147749889 (0x80041001)
-
L'appel a échoué.
Remarques
VT _ Les valeurs de 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 a la valeur false:
- YearSpecified
- MonthSpecified
- DaySpecified
- HoursSpecified
- MinutesSpecified
- SecondsSpecified
- MicrosecondsSpecified
- UTCSpecified
En cas de retour réussi de SetFileTime, toutes ces propriétés ont la valeur true.
Exemples
Pour obtenir des exemples d’utilisation de l’objet SWbemDateTime pour convertir des valeurs DateTime CIM vers et à partir du format fileTime ou du format de _ Date VT , consultez tâches WMI : dates et heures. Pour obtenir une description du format DateTime CIM, consultez format de date et d’heure.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| En-tête |
|
| Bibliothèque de types |
|
| DLL |
|
| CLSID |
CLSID _ SWbemDateTime |
| IID |
IID _ ISWbemDateTime |