SWbemDateTime.SetFileTime-Methode

Die SetFileTime-Methode des SWbemDateTime-Objekts konvertiert ein Datum im FILETIME-Zeichenfolgenformat in das CIM-basierte Datums- und Uhrzeitformat.

Das FILETIME-Format ist eine 64-Bit-Struktur für Datums- und Uhrzeitangaben, die die Anzahl der Einheiten von 100 Nanosekunden 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 der Syntax finden Sie unter Dokumentkonventionen für die Skripterstellungs-API.

Syntax

SWbemDateTime.SetFileTime( _
  ByVal strFileTime, _
  [ ByVal bIsLocal ] _
)

Parameter

strFileTime [in]

FILETIME-Wert, der zum Festlegen des Objekts verwendet wird.

bIsLocal [in, optional]

Wenn „bIsLocal“ auf TRUE festgelegt ist, wird strFileTime als Ortszeit interpretiert. Die UTC-Eigenschaft (Coordinated Universal Time) enthält die in den richtigen UTC-Offset konvertierte Ortszeit. Wenn bIsLocalauf FALSE festgelegt ist, wird strFileTime 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 SetFileTime-Methode enthält das Err-Objekt möglicherweise den Fehlercode aus der folgenden Liste.

wbemErrInvalidSyntax – 2147749921 (0x80041021)

Das Format von strFileTime ist ungültig.

Bemerkungen

Nach einem erfolgreichen Aufruf von SetFileTime wird der DATETIME-Wert immer als absoluter Wert (datetime) interpretiert, und IsInterval ist auf FALSE 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.SetVarDate

SWbemDateTime

DATETIME