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 |