Método SWbemObjectEx.Refresh_

Artigo
06/29/2023

O método Refresh_ do SWbemObjectEx atualiza os dados para objetos que possuem dados fornecidos por um provedor de desempenho, como as Classes de Contador de Desempenho. Você pode obter dados atualizados mais rapidamente e sem uma chamada para SWbemServices.Get_.

Para obter mais informações sobre essa sintaxe, consulte Convenções de documentação para a API de script.

Sintaxe

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

Parâmetros

iFlags [in, opcional]: Sinalizadores de operação reservados que, se especificados, devem ser 0 (zero).
objWbemNamedValueSet [in, opcional]: Um objeto SWbemNamedValueSet que define o contexto para a operação.

Retornar valor

Esse método não retorna um valor.

Códigos do Erro

Após a conclusão do método Refresh_, o objeto Err pode conter um dos códigos de erro da lista a seguir.

wbemErrFailed – 2147749889 (0x80041001): O provedor falhou internamente, mesmo que a operação fosse válida.
wbemErrNotFound – 2147749890 (0x80041002): O formato solicitado não foi encontrado.
wbemErrInvalidParameter – 2147749896 (0x80041008): Um dos parâmetros para a chamada não está correto.
wbemErrRefresherBusy – 2147749975 (0x80041057): O atualizador está ocupado com outra operação.
wbemPartialResults – 2147745808 (0x80040010): Nem todos os objetos, enumeradores ou atualizadores aninhados foram atualizados com êxito. Esse retorno não é um erro, mas uma indicação de que a operação foi incompleta.

Exemplos

O exemplo de código de script a seguir mostra como obter contadores de desempenho brutos e cozidos para o processo do sistema. Os objetos são atualizados a cada dois segundos e as propriedades são exibidas.

' 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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Cabeçalho	Wbemdisp.h
Biblioteca de tipos	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObjectEx
IID	IID_ISWbemObjectEx

Confira também

SWbemObjectEx
Monitoramento de dados de desempenho