SWbemDateTime.SetVarDate-Methode
Die SetVarDate-Methode des SWbemDateTime-Objekts konvertiert ein Datum aus dem VT_DATE-Format in das CIM-datetime-Format.
Ein VT_DATE-Wert ist ein Variant-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
SWbemDateTime.SetVarDate( _
ByVal vdate, _
[ ByVal bIsLocal ] _
)
Parameter
-
vdate [in]
-
Der Wert des Variant-Datumswerts zum Festlegen des Objekts. Dieser Parameter muss im VT_DATE-Format vorliegen.
-
bIsLocal [in, optional]
-
Bei TRUE wird vdate als Ortszeit interpretiert, und die UTC-Eigenschaft (Coordinated Universal Time) enthält die Ortszeit, die in den richtigen UTC-Offset konvertiert wird. Wenn bIsLocal auf FALSE festgelegt ist, wird vdate 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 SetVarDate-Methode enthält das Err-Objekt möglicherweise den Fehlercode aus der folgenden Liste.
-
wbemErrInvalidSyntax – 2147749921 (0x80041021)
-
Das Format von vdate ist ungültig.
Hinweise
Nach einem erfolgreichen Aufruf von SetVarDate wird der DATETIME-Wert als absoluter datetime-Wert und nicht als Intervall interpretiert, und die IsInterval-Eigenschaft wird auf FALSE festgelegt.
Die systeminterne Visual Basic- oder VBScript-Funktion CDate stellt einen datetime-Wert im VT_DATE-Format für die Eingabe in SetVarDate bereit.
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 |