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
Wbemdisp.h
Typbibliothek
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID _ SWbemDateTime
IID
IID _ ISWbemDateTime

Siehe auch

SWbemDateTime.SetFileTime

SWbemDateTime

Datetime