Méthode SWbemDateTime.SetVarDate

Article
11/12/2023

La méthode SetVarDate de l’objet SWbemDateTime convertit une valeur de date de format VT_DATE au format CIM datetime.

Une valeur VT_DATE est une valeur datetime variante utilisée par Visual Basic et ActiveX.

Pour obtenir une explication de cette syntaxe, consultez Conventions de document pour l’API de script.

Syntaxe

SWbemDateTime.SetVarDate( _
  ByVal vdate, _
  [ ByVal bIsLocal ] _
)

Paramètres

vdate [entrée]: Valeur de date variante pour définir l’objet. Ce paramètre doit être au format VT_DATE .
bIsLocal [entrée, facultatif]: Si TRUE, vdate est interprétée comme une heure locale, et la propriété UTC (Coordinated Universal Time) contiendra l’heure locale convertie avec le décalage UTC correct. Lorsque bIsLocal a la valeur FALSE, vdate sera directement converti 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 SetVarDate, l’objet Err peut contenir un code d’erreur de la liste suivante.

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

Notes

Après un appel réussi à SetVarDate, la valeur DATETIME est interprétée comme une valeur absolue de date au lieu d'un intervalle, et la propriété IsInterval prend la valeur FALSE.

La fonction intrinsèque Visual Basic ou VBScript CDate fournit une valeur datetime au format VT_DATE à l’entrée dans SetVarDate.

Exemples

Pour obtenir des exemples d’utilisation de l’objet SWbemDateTime afin de convertir des valeurs CIM DATETIME depuis et vers le format FILETIME ou VT_DATE, 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	Value
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.SetFileTime
SWbemDateTime
DATETIME

Partager via