SWbemDateTime.GetFileTime 方法

SWbemDateTime 对象的 GetFileTime 方法将 CIM DATETIME 格式的日期和时间值转换为 FILETIME 格式。

如果参数设置为 TRUE，则返回值表示客户端的本地时间。 否则，返回值是协调世界时 (UTC) 时间。 FILETIMEDATETIME 结构是一个 64 位值，表示自 1601 年 1 月 1 日开始以来 100 纳秒单位的数量。 Windows Management Instrumentation (WMI) 将 FILETIME 值视为无符号 64 位数字的字符串表示形式。

有关此语法的说明，请参阅脚本 API 的文档约定。

语法

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

parameters

bIsLocaL [in, optional]

指示返回值是否被解释为本地时间。 UTC 属性包含转换为正确的协调世界时 (UTC) 偏移量的本地时间。 如果值为 FALSE，则该值被解释为具有零 (0) 偏移量的 UTC。

返回值

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