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 |
标头 |
|
类型库 |
|
DLL |
|
CLSID |
CLSID_SWbemDateTime |
IID |
IID_ISWbemDateTime |