Constantes de l’API de script

  • Article

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

WbemAuthenticationLevelEnum

Définit les niveaux d’authentification de sécurité.

WbemChangeFlagEnum

Définit la façon dont une opération d’écriture dans une classe ou un instance est effectuée.

WbemCimTypeEnum

Définit les types CIM valides d’une valeur de propriété.

WbemComparisonFlagEnum

Définit les paramètres de comparaison d’objets, et est utilisée par SWbemObject.CompareTo_.

WbemConnectOptionsEnum

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.

WbemErrorEnum

Définit les erreurs qui peuvent être retournées par les appels à l’API de script pour WMI.

WbemFlagEnum

Définit les constantes utilisées par SWbemServices.ExecQuery, SWbemServices.ExecQueryAsync, SWbemServices.SubclassesOf et SWbemServices.InstancesOf.

WbemImpersonationLevelEnum

Définit les niveaux d’emprunt d’identité de sécurité. Ces constantes sont utilisées avec SWbemSecurity.

WbemObjectTextFormatEnum

Définit les formats de texte d’objet valides à utiliser par SWbemObjectEx.GetText_.

WbemPrivilegeEnum

Définit les privilèges. Ces constantes sont utilisées avec SWbemSecurity pour accorder les privilèges requis pour certaines opérations.

WbemQueryFlagEnum

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.

WbemTextFlagEnum

Définit le contenu du texte d’objet généré, et est utilisée par SWbemObject.GetObjectText_.

WbemTimeout

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.

API de script pour WMI