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 |
|
| Typbibliothek |
|
| DLL |
|
| CLSID |
CLSID_SWbemDateTime |
| IID |
IID_ISWbemDateTime |