Constantes de l’API de script
WMI utilise plusieurs types de constantes dans le paramètre iflags des appels de méthode dans l’API de script pour WMI.
Les applications Visual Basic peuvent inclure la bibliothèque de types pour l’API de script, Wbemdisp.tlb. Les scripts ne peuvent pas accéder aux constantes dans la bibliothèque de types, sauf s’ils utilisent les étiquettes <REFERENCE> ou <OBJECT> du format de fichier XML WSH (Windows Script Host) comme décrit dans Utilisation de la bibliothèque de types de script WMI. Autrement, un script doit utiliser la valeur de la constante.
Constantes
-
Définit les niveaux d’authentification de sécurité.
-
Définit la façon dont une opération d’écriture dans une classe ou un instance est effectuée.
-
Définit les types CIM valides d’une valeur de propriété.
-
Définit les paramètres de comparaison d’objets, et est utilisée par SWbemObject.CompareTo_.
-
Définit un indicateur de sécurité utilisé comme paramètre dans les appels à la méthode SWbemLocator.ConnectServer lorsqu’une connexion à WMI sur un ordinateur distant échoue.
-
Définit les erreurs qui peuvent être retournées par les appels à l’API de script pour WMI.
-
Définit les constantes utilisées par SWbemServices.ExecQuery, SWbemServices.ExecQueryAsync, SWbemServices.SubclassesOf et SWbemServices.InstancesOf.
-
Définit les niveaux d’emprunt d’identité de sécurité. Ces constantes sont utilisées avec SWbemSecurity.
-
Définit les formats de texte d’objet valides à utiliser par SWbemObjectEx.GetText_.
-
Définit les privilèges. Ces constantes sont utilisées avec SWbemSecurity pour accorder les privilèges requis pour certaines opérations.
-
Définit la profondeur de l’énumération ou de la requête, qui détermine le nombre d’objets retournés par un appel.
-
Définit le contenu du texte d’objet généré, et est utilisée par SWbemObject.GetObjectText_.
-
Définit les constantes de délai d’attente. Cette constante est utilisée par SWbemEventSource.NextEvent.
Combinaison d’indicateurs
Vous pouvez combiner des indicateurs pour affecter plusieurs aspects de l’appel d’API.
Par exemple, pour créer un appel semi-synchrone, le paramètre iFlags dans un appel SWbemServices.ExecQuery_ doit contenir deux indicateurs : WbemFlagReturnImmediately et WbemFlagForwardOnly. La valeur de WbemFlagReturnImmediately est 16 et la valeur de WbemFlagForwardOnly est 32. Étant donné que les constantes ne sont pas accessibles par nom, les valeurs de ces indicateurs sont combinées, ce qui produit une valeur iFlags de 48.
L’exemple de script suivant montre l’appel.
On Error Resume Next
For Each obj in GetObject("WinMgmts:").ExecQuery _
("SELECT * FROM Win32_NTLogEvent WHERE _ LogFile='Application'",,48)
count = count + 1
Next
Tous les indicateurs ne peuvent pas être combinés, car beaucoup s’excluent mutuellement et peuvent produire des résultats imprévisibles.
Rubriques connexes