SWbemDateTime.GetVarDate-Methode
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:
- YearSpecified
- MonthSpecified
- DaySpecified
- HoursSpecified
- MinutesSpecified
- SecondsSpecified
- MicrosecondsSpecified
- UTCSpecified
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 |
|
| Typbibliothek |
|
| DLL |
|
| CLSID |
CLSID_SWbemDateTime |
| IID |
IID_ISWbemDateTime |