SWbemObjectEx.Refresh_ method

Article
06/13/2023

La méthode Refresh_ de SWbemObjectEx met à jour les données des objets qui ont des données fournies par un fournisseur de performances, comme les classes de compteur de performances. Vous pouvez obtenir des données mises à jour plus rapidement et sans appel à SWbemServices.Get_.

Pour obtenir une explication de cette syntaxe, consultez Conventions de document pour l’API de script.

Syntaxe

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

Paramètres

iFlags [in, facultatif]: Indicateurs d’opération réservés qui, s’ils sont spécifiés, doivent être 0 (zéro).
objWbemNamedValueSet [in, facultatif]: Un 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 de la liste suivante.

wbemErrFailed - 2147749889 (0x80041001): Le fournisseur a échoué en interne, même si l’opération était 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): Tous les objets, énumérateurs ou actualisations imbriqués n’ont pas tous été mis à jour avec succès. Ce retour n’est pas une erreur, mais une indication que l’opération était incomplète.

Exemples

L’exemple de code de script suivant montre comment obtenir des compteurs de performances crus et cuits 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

Spécifications

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
Supervision des données de performance

Partager via