SWbemObjectEx. Refresh, _ méthode

La méthode _ Refresh de SWbemObjectEx met à jour les données pour les objets qui ont des données fournies par un fournisseur de performances, telles que les classes de compteur de performance. Vous pouvez obtenir des données mises à jour plus rapidement et sans appel à SWbemServices _ . obtenir.

Pour plus d’informations sur cette syntaxe, consultez conventions de document pour l’API de script.

Syntaxe

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

Paramètres

IFlags [ dans, facultatif]

Indicateurs d’opération réservée qui, s’ils sont spécifiés, doivent avoir la valeur 0 (zéro).

objWbemNamedValueSet [ dans, facultatif]

Objet SWbemNamedValueSet qui définit le contexte de l’opération.

Valeur retournée

Cette méthode ne retourne pas de valeur.

Codes d’erreur

Une fois la méthode Refresh _ terminée, l’objet Err peut contenir l’un des codes d’erreur répertoriés dans la liste suivante.

wbemErrFailed -2147749889 (0x80041001)

Le fournisseur a échoué en interne, même si l’opération est valide.

wbemErrNotFound -2147749890 (0x80041002)

Le format demandé est introuvable.

wbemErrInvalidParameter -2147749896 (0x80041008)

Un des paramètres de l'appel n'est pas correct.

wbemErrRefresherBusy -2147749975 (0x80041057)

L'actualisateur est occupé par une autre opération.

wbemPartialResults -2147745808 (0x80040010)

Les objets, les énumérateurs ou les actualisateurs imbriqués n’ont pas tous été mis à jour. Ce retour n’est pas une erreur, mais indique que l’opération n’est pas terminée.

Exemples

L’exemple de code de script suivant montre comment obtenir des compteurs de performances bruts et cuisinés pour le processus système. Les objets sont actualisés toutes les deux secondes et les propriétés affichées.

' 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

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
En-tête
Wbemdisp. h
Bibliothèque de types
Wbemdisp. tlb
DLL
Wbemdisp.dll
CLSID
CLSID _ SWbemObjectEx
IID
IID _ ISWbemObjectEx

Voir aussi

SWbemObjectEx

Analyse des données de performances