WBEMTime：：SetDMTF 方法 (wbemtime.h)

[ WBEMTime 類別是 WMI 提供者架構的一部分，其現在被視為最終狀態，而且不會影響這些連結庫的非安全性相關問題將不會有進一步的開發、增強功能或更新。 MI API 應該用於所有新的開發。]

SetDMTF 方法會設定 WBEMTime 物件中的時間。時間是由其 BSTR 參數以日期和時間格式提供。 1601 年 1 月 1 日午夜之前的日期和時間自變數無效。

語法

BOOL SetDMTF(
  const BSTR wszText
);

wszText

如果時間有效，則方法會傳回 true ;如果時間無效，則傳回 false 。

在內部， WBEMTime 會將日期時間儲存為64位整數。因此，設定 datetime 時，必須使用星號的實作特定解譯。

當星號「*」出現在輸入日期時間字串的任何位置時， wszText 會以預設日期時間字串「160101010100000000.00000+000」取代位置。

微秒分隔符 “.” 和 UTC 位移符號 “+/-” 必須存在於正確的位置。如果在對應的位置偵測到星號，所有其他位置都會由預設元素取代。

例如，“1979**********.000000-0*4” 會變成 “19791010100000000.0000000-004”。

由於 WBEMTime 會在內部儲存 GMT 中的所有日期時間值，因此產生的 UTC 為 -004 會導致分鐘字段變更，使內部表示變成 “197910105000000.000000+000”。