Partager via


SWbemDateTime.SetFileTime method

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