SWbemDateTime.SetFileTime method

Article
06/29/2023

La méthode SetFileTime de l’objet SWbemDateTime convertit une date dans la chaîne FILETIME au format CIM datetime.

Le format FILETIME est une structure datetime 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 l’explication de la syntaxe, consultez Conventions de document pour l’API de script.

Syntaxe

SWbemDateTime.SetFileTime( _
  ByVal strFileTime, _
  [ ByVal bIsLocal ] _
)

Paramètres

strFileTime [in]: Valeur FILETIME utilisée pour définir l’objet.
bIsLocal [in, optional]: Si la valeur est TRUE, strFileTime est interprété comme une heure locale. La propriété UTC (Temps universel coordonné) contient l’heure locale convertie en décalage UTC correct. Lorsque bIsLocal a la valeur FALSE, strFileTime est converti directement en valeur UTC avec un décalage de 0 (zéro).

Valeur retournée

Cette méthode ne retourne pas de valeur.

Codes d’erreur

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

wbemErrInvalidSyntax - 2147749921 (0x80041021): Le format de strFileTime n’est pas valide.

Notes

Après un appel réussi à SetFileTime, la valeur datetime est toujours interprétée comme une valeur absolue (datetime) et IsInterval est défini sur FALSE.

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

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
En-tête	Wbemdisp.h
Bibliothèque de types	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemDateTime
IID	IID_ISWbemDateTime

Voir aussi

SWbemDateTime.SetVarDate
SWbemDateTime
DATETIME