SWbemDateTime.SetVarDate-Methode
Die SetVarDate-Methode des SWbemDateTime-Objekts konvertiert ein Datum im VT _ DATE-Format in das CIM datetime-Format.
Ein VT _ DATE-Wert ist ein variant datetime-Wert, der Visual Basic und ActiveX wird.
Eine Erläuterung dieser Syntax finden Sie unter Dokumentkonventionen für die Skripterstellungs-API.
Syntax
SWbemDateTime.SetVarDate( _
ByVal vdate, _
[ ByVal bIsLocal ] _
)
Parameter
-
vdate [ In]
-
Der Variant-Datumswert zum Festlegen des -Objekts. Dieser Parameter muss im VT _ DATE-Format vorliegen.
-
bIsLocal [ in, optional]
-
True gibt an, dass vdate als lokale Zeit interpretiert wird, und die koordinierte Weltzeit (UTC)-Eigenschaft enthält die Ortszeit, die in den richtigen UTC-Offset konvertiert wird. Wenn bIsLocal FALSE ist, wird vdate direkt in einen UTC-Wert mit einem Offset von 0 (null) konvertiert.
Rückgabewert
Diese Methode gibt keinen Wert zurück.
Fehlercodes
Nach Abschluss der SetVarDate-Methode enthält das Err-Objekt möglicherweise den Fehlercode in der folgenden Liste.
-
wbemErrInvalidSyntax – 2147749921 (0x80041021)
-
Das Format von vdate ist ungültig.
Hinweise
Nach einem erfolgreichen Aufruf von SetVarDate wird der DATETIME-Wert als absoluter datetime-Wert anstelle eines Intervalls interpretiert, und die IsInterval-Eigenschaft wird auf FALSE festgelegt.
Die systeminterne Visual Basic- oder VBScript-Funktion CDate stellt einen datetime-Wert im VT _ DATE-Format für die Eingabe in SetVarDate zur Verfügung.
Beispiele
Beispiele für die Verwendung des SWbemDateTime-Objekts zum Konvertieren von CIM DATETIME-Werten in und aus dem FILETIME-Format oder dem VT _ DATE-Format finden Sie unter WMI Tasks: Dates and Times. Eine Beschreibung des CIM DATETIME-Formats finden Sie unter Datums- und Uhrzeitformat.
Im Codebeispiel Convert Date to WMI Date-Time Format VBScript im TechNet Gallery wird SetVarDate verwendet, um einen regulären Datums-/Uhrzeitwert in das UTC-Format für Datum und Uhrzeit zu konvertieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Header |
|
| Typbibliothek |
|
| DLL |
|
| CLSID |
CLSID _ SWbemDateTime |
| IID |
IID _ ISWbemDateTime |