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 ] _
)

parameters

strFileTime [in]

用于设置对象的 FILETIME 值。

bIsLocal [in, 可选]

如果 为 TRUEstrFileTime 将解释为本地时间。 协调世界时 (UTC) 属性包含转换为正确的 UTC 偏移量的本地时间。 如果 bIsLocalFALSE则 strFileTime 将直接转换为 UTC 值,偏移量为 0 (零) 。

返回值

此方法不返回值。

错误代码

完成 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