Метод SWbemObjectEx.Refresh_

Статья
06/13/2023

Метод Refresh_SWbemObjectEx обновляет данные для объектов, которые предоставляются поставщиком производительности, например классы счетчиков производительности. Обновленные данные можно получить быстрее и без вызова SWbemServices.Get_.

Дополнительные сведения об этом синтаксисе см. в разделе Соглашения о документах для API сценариев.

Синтаксис

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

Параметры

iFlags [in, необязательный]: Флаги зарезервированных операций, которые, если они указаны, должны иметь значение 0 (ноль).
objWbemNamedValueSet [in, необязательный]: Объект 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
Мониторинг данных производительности