Méthode SWbemDateTime. SetFileTime

La méthode SetFileTime de l’objet SWbemDateTime convertit une date au format fileTime de chaîne au format DateTime CIM .

Le format fileTime est une structure datetime de 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 plus d’explications sur la syntaxe, consultez conventions de document pour l’API de script.

Syntaxe

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

Paramètres

strFileTime [ dans]

Valeur fileTime utilisée pour définir l’objet.

bIsLocal [ dans, facultatif]

Si la valeur est true, strFileTime est interprété comme une heure locale. La propriété temps universel coordonné (UTC, Universal Time Coordinated) contient l’heure locale convertie en décalage UTC correct. Quand bIsLocal a la valeur false, strFileTime est converti directement en valeur UTC avec un décalage égal à 0 (zéro).

Valeur de retour

Cette méthode ne retourne pas de valeur.

Codes d’erreur

À la fin de la méthode SetFileTime , l’objet Err peut contenir le code d’erreur figurant dans 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 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.

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

Date/heure