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

Siehe auch

SWbemDateTime.SetFileTime

SWbemDateTime

DATETIME