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:

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
Wbemdisp. h
Bibliothèque de types
Wbemdisp. tlb
DLL
Wbemdisp.dll
CLSID
CLSID _ SWbemDateTime
IID
IID _ ISWbemDateTime

Voir aussi

SWbemDateTime. getVarDate,

SWbemDateTime

Date/heure