SWbemDateTime.GetFileTime-Methode
Die GetFileTime-Methode des SWbemDateTime-Objekts konvertiert einen Datums- und Uhrzeitwert im CIM-DATETIME-Format in das FILETIME-Format.
Wenn der Parameter auf TRUE festgelegt ist, stellt der Rückgabewert eine lokale Zeit für den Client dar. Andernfalls ist der Rückgabewert eine UTC-Zeit (Coordinated Universal Time). Eine FILETIMEDATETIME-Struktur ist ein 64-Bit-Wert, der die Anzahl der 100-Nanosekunden-Einheiten seit dem 1. Januar 1601 darstellt. Die Windows-Verwaltungsinstrumentation (Windows Management Instrumentation, WMI) behandelt FILETIME-Werte als Zeichenfolgendarstellungen von 64-Bit-Zahlen ohne Vorzeichen.
Eine Erläuterung dieser Syntax finden Sie unter Dokumentkonventionen für die Skripterstellungs-API.
Syntax
vDate = .GetFileTime( _
[ ByVal bIsLocaL ] _
)
Parameter
-
bIsLocaL [in, optional]
-
Gibt an, ob der zurückgegebene Wert als lokale Zeit interpretiert wird. Die UTC-Eigenschaft enthält dann die lokale Zeit, die in den richtigen UTC-Versatz (Coordinated Universal Time) konvertiert wird. Wenn der Wert FALSE lautet, wird der Wert als UTC mit einem Versatz von 0 (null) interpretiert.
Rückgabewert
Das Datum und die Uhrzeit im FILETIME-Format.
Fehlercodes
Nach Abschluss der GetFileTime-Methode kann das Err-Objekt den Fehlercode in der folgenden Liste enthalten.
-
wbemErrFailed – 2147749889 (0x80041001)
-
Der Aufruf schlug fehl.
Bemerkungen
VT_DATE- und FILETIME-Werte dürfen keine Platzhalterfelder enthalten.
Bei der GetFileTime-Methode tritt ein Fehler auf (wbemErrFailed), wenn eine der folgenden Eigenschaften FALSE ist:
- YearSpecified
- MonthSpecified
- DaySpecified
- HoursSpecified
- MinutesSpecified
- SecondsSpecified
- MicrosecondsSpecified
- UTCSpecified
Bei einer erfolgreichen Rückgabe von SetFileTime werden alle diese Eigenschaften auf TRUE festgelegt.
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 |