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 |
|
| Bibliothèque de types |
|
| DLL |
|
| CLSID |
CLSID _ SWbemObjectEx |
| IID |
IID _ ISWbemObjectEx |