SWbemDateTime.GetFileTime 方法

SWbemDateTime物件的GetFileTime方法會將 CIM DATETIME格式的日期和時間值轉換為 FILETIME 格式。

如果參數設定為 TRUE，則傳回值代表用戶端的當地時間。 否則，傳回值為國際標準時間 (UTC) 時間。 FILETIME DATETIME結構是 64 位值，代表自 1601 年 1 月 1 日起 100 奈秒單位的數目。 Windows Management Instrumentation (WMI) 會將 FILETIME 值視為不帶正負號 64 位數位的字串表示。

如需此語法的說明，請參閱 腳本 API 的檔慣例。

語法

vDate = .GetFileTime( _
  [ ByVal bIsLocaL ] _
)

參數

bIsLocaL [in， 選擇性]

指出傳回的值是否解譯為當地時間。 UTC 屬性接著會包含轉換成正確國際標準時間 (UTC) 位移的當地時間。 如果值為 FALSE，則會將值解譯為 UTC，且 (0) 位移。

傳回值

FILETIME格式的日期和時間。

錯誤碼

完成 GetFileTime 方法之後， Err 物件可能會包含下列清單中的錯誤碼。

wbemErrFailed - 2147749889 (0x80041001)

呼叫失敗。

備註

VT_DATE 和 FILETIME 值不能包含萬用字元欄位。

如果下列任一屬性為FALSE，GetFileTime方法會失敗 (wbemErrFailed) ：

• YearSpecified
• MonthSpecified
• DaySpecified
• HoursSpecified
• MinutesSpecified
• SecondsSpecified
• MicrosecondsSpecified
• UTCSpecified

在 SetFileTime成功傳回時，所有這些屬性都會設定為 TRUE。

範例

如需使用 SWbemDateTime 物件將 CIM DATETIME 值轉換成 FILETIME 格式或 VT_DATE 格式的範例，請參閱 WMI 工作：日期和時間。 如需 CIM DATETIME 格式的描述，請參閱 日期和時間格式。

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
標頭	Wbemdisp.h
類型程式庫	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemDateTime
IID	IID_ISWbemDateTime

另請參閱

SWbemDateTime.GetVarDate

SWbemDateTime

Datetime