SWbemDateTime.SetFileTime 方法

SWbemDateTime 对象的 SetFileTime 方法将字符串 FILETIME 格式的日期转换为 CIM 日期/时间 格式。

FILETIME 格式是一个 64 位日期时间结构,表示自 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 将直接转换为偏移量为 0(零)的 UTC 值。

返回值

此方法不返回值。

错误代码

完成 SetFileTime 方法后,Err 对象可能包含以下列表中的错误代码。

wbemErrInvalidSyntax - 2147749921 (0x80041021)

strFileTime 的格式无效。

备注

成功调用 SetFileTime 后,datetime 值始终被解释为绝对(日期/时间)值,并且 IsInterval 设置为 FALSE。

示例

有关使用 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.SetVarDate

SWbemDateTime

DATETIME