SWbemDateTime.SetFileTime 方法
SWbemDateTime物件的SetFileTime方法會將字串FILETIME格式的日期轉換為CIM 日期時間格式。
FILETIME 格式是 64 位的 datetime 結構,代表自 1601 年 1 月 1 日起的 100 奈秒單位數目。 Windows Management Instrumentation (WMI) 會將 FILETIME 值視為不帶正負號 64 位數位的字串表示。
如需語法說明,請參閱 腳本 API 的檔慣例。
語法
SWbemDateTime.SetFileTime( _
ByVal strFileTime, _
[ ByVal bIsLocal ] _
)
參數
-
strFileTime [in]
-
用來設定 物件的FILETIME值。
-
bIsLocal [in, optional]
-
如果 為 TRUE, strFileTime 會解譯為當地時間。 國際標準時間 (UTC) 屬性包含轉換成正確 UTC 位移的當地時間。 當 bIsLocal 為 FALSE時, strFileTime 會直接轉換成 UTC 值,其位移為 0 (零) 。
傳回值
這個方法不會傳回值。
錯誤碼
完成 SetFileTime 方法之後, Err 物件可能會包含下列清單中的錯誤碼。
-
wbemErrInvalidSyntax - 2147749921 (0x80041021)
-
strFileTime的格式無效。
備註
成功呼叫 SetFileTime之後, datetime 值一律會解譯為絕對 (datetime) 值, 而 IsInterval 會設定為 FALSE。
範例
如需使用 SWbemDateTime 物件將 CIM DATETIME 值轉換成 FILETIME 格式或 VT_DATE 格式的範例,請參閱 WMI 工作:日期和時間。 如需 CIM DATETIME 格式的描述,請參閱 日期和時間格式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows Vista |
最低支援的伺服器 |
Windows Server 2008 |
標頭 |
|
類型程式庫 |
|
DLL |
|
CLSID |
CLSID_SWbemDateTime |
IID |
IID_ISWbemDateTime |