WBEMTime::SetDMTF-Methode (wbemtime.h)

[Die WBEMTime-Klasse ist Teil des WMI-Anbieterframeworks, das jetzt als final betrachtet wird. Es sind keine weiteren Entwicklungen, Verbesserungen oder Updates für nicht sicherheitsrelevante Probleme verfügbar, die diese Bibliotheken betreffen. Für alle Neuentwicklungen sollten die MI-APIs verwendet werden.]

Die SetDMTF-Methode legt die Zeit im WBEMTime-Objekt fest. Die Uhrzeit wird durch den BSTR-Parameter im Datums- und Uhrzeitformat angegeben. Ein Datums- und Uhrzeitargument vor Mitternacht 1. Januar 1601 ist ungültig.

Syntax

BOOL SetDMTF(
  const BSTR wszText
);

Parameter

wszText

BSTR im Datums- und Uhrzeitformat.

Rückgabewert

Die Methode gibt true zurück, wenn die Zeit gültig ist, und false , wenn die Zeit ungültig ist.

Hinweise

Intern speichert WBEMTime eine datetime als ganze 64-Bit-Zahl. Aus diesem Grund ist eine implementierungsspezifische Interpretation für die Verwendung eines Sternchens erforderlich, wenn ein datetime festgelegt wird.

Wenn ein Sternchen "*" an einer beliebigen Position in der eingehenden datetime-Zeichenfolge angezeigt wird, wird wszText positionsbezogen durch die standardmäßige datetime-Zeichenfolge "160101000000.000000+000" ersetzt.

Das Mikrosekundentrennzeichen "." und das UTC-Offsetzeichen "+/-" müssen an den richtigen Stellen vorhanden sein. Alle anderen Positionen werden durch das Standardelement ersetzt, wenn ein Sternchen an der entsprechenden Position erkannt wird.

Beispielsweise wird "1979**********.0000000-0*4" zu "1979101000000.000000-004".

Da WBEMTime intern alle datetime-Werte in GMT speichert, bewirkt die resultierende UTC von -004, dass sich das Minutenfeld ändert, sodass die interne Darstellung zu "1979105000000.00000+000" wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wbemtime.h
DLL	FrameDynOS.dll; FrameDyn.dll

Weitere Informationen

WBEMTime

WBEMTime::GetBSTR

WBEMTime::GetDMTF