SWbemDateTime.GetVarDate-Methode

  • Artikel

Die GetVarDate-Methode des SWbemDateTime-Objekts konvertiert einen Datums- und Uhrzeitwert aus dem DATETIME-Format von CIM in das VT_DATE-Format.

Das VT_DATE-Format ist ein automatisierungsvariabler DATETIME-Wert, der von Visual Basic und ActiveX verwendet wird.

Eine Erläuterung dieser Syntax finden Sie in den Dokumentkonventionen für die Skripterstellungs-API.

Syntax

vdate = .GetVarDate( _
  [ ByVal bIsLocal ] _
)

Parameter

bIsLocal [in, optional]

Gibt an, ob der zurückgegebene Wert als Ortszeit interpretiert wird. Die UTC-Eigenschaft (koordinierte Weltzeit) enthält die in die richtige UTC-Abweichung konvertierte Ortszeit. Wenn der Wert FALSE lautet, wird der Wert als UTC ohne Abweichung interpretiert.

Rückgabewert

Der Datums- und Uhrzeitwert im VT_DATE-Format.

Bemerkungen

VT_DATE- und FILETIME-Werte dürfen keine Platzhalterfelder enthalten.

Bei der GetVarDate-Methode tritt ein Fehler (wbemErrFailed) auf, wenn eine der folgenden Eigenschaften FALSE ist:

Bei erfolgreicher Rückgabe von SetVarDate werden alle diese Eigenschaften auf TRUE festgelegt.

Nach einem erfolgreichen Aufruf von SetVarDate wird der DATETIME-Wert immer als absoluter DATETIME-Wert (nicht als Intervall) interpretiert, und IsInterval wird auf FALSE festgelegt.

Wenn IsInterval auf TRUE festgelegt ist, tritt beim Aufrufen von GetVarDate der Fehler wbemErrFailed auf.

Durch Aufrufen von GetVarDate kommt es zu einem gewissen Genauigkeitsverlust, da datetime-Werte eine Auflösung von einer Mikrosekunde (s) haben und die Auflösung von VT_DATE-Werten bei 500 Millisekunden liegt.

Beispiele

Beispiele für die Verwendung des SWbemDateTime-Objekts, um DATETIME-Werte von CIM in das FILETIME- oder VT_DATE-Format bzw. aus diesen Formaten zu konvertieren, finden Sie unter WMI-Aufgaben: Datums- und Uhrzeitangaben. Eine Beschreibung des CIM-DATETIME-Formats finden Sie unter Datums- und Uhrzeitformat.

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

Weitere Informationen

SWbemDateTime.GetFileTime

SWbemDateTime

DATETIME