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	Wbemdisp.h
Typbibliothek	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemDateTime
IID	IID_ISWbemDateTime

Weitere Informationen

SWbemDateTime.GetVarDate

SWbemDateTime

DATETIME