SWbemObjectEx.Refresh_ 方法

SWbemObjectEx 的 Refresh_ 方法为具有性能提供程序提供的数据的对象(例如性能计数器类)更新数据。 你可以更快地获取更新的数据,不需要调用 SWbemServices.Get_

有关此语法的详细信息,请参阅脚本 API 的文档约定

语法

SWbemObjectEx.Refresh_( _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ] _
)

parameters

iFlags [输入参数,可选]

保留的操作标志,如果指定,则必须为 0(零)。

objWbemNamedValueSet [输入参数,可选]

设置操作上下文的 SWbemNamedValueSet 对象。

返回值

此方法不返回值。

错误代码

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

wbemErrFailed - 2147749889 (0x80041001)

提供程序在内部失败,即使操作有效也是如此。

wbemErrNotFound - 2147749890 (0x80041002)

找不到请求的格式。

wbemErrInvalidParameter - 2147749896 (0x80041008)

调用的参数之一不正确。

wbemErrRefresherBusy - 2147749975 (0x80041057)

刷新程序正忙于进行另一个操作。

wbemPartialResults - 2147745808 (0x80040010)

并非所有对象、枚举器或嵌套刷新器都已成功更新。 此返回值不是错误,而是指示操作未完成。

示例

以下脚本代码示例展示了如何获取系统进程的原始和已处理的性能计数器。 对象每两秒刷新一次,并显示属性。

' Get the performance counter instance for the System process
set PerfRaw = GetObject( _
    "winmgmts:win32_perfrawdata_perfproc_process.name='system'")
set PerfCooked = GetObject( _
    "winmgmts:win32_perfformatteddata_perfproc_process.name='system'")

' Display some properties in a loop
for I = 1 to 5
    Wscript.Echo "HandleCount = "& PerfRaw.HandleCount & _
         " Raw ThreadCount = " & PerfRaw.ThreadCount & _
        " Cooked ThreadCount = " & PerfCooked.ThreadCount
    
    Wscript.Sleep 2000
    
' Refresh the objects
    PerfRaw.Refresh_
    PerfCooked.Refresh_
next

要求

要求
最低受支持的客户端
Windows Vista
最低受支持的服务器
Windows Server 2008
标头
Wbemdisp.h
类型库
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID_SWbemObjectEx
IID
IID_ISWbemObjectEx

另请参阅

SWbemObjectEx

监视性能数据