Méthode SWbemObject.Instances_
La méthode Instances_ de l’objet SWbemObject crée un énumérateur qui retourne les instances de l’objet de classe actuel. Cette méthode implémente une requête simple. Des requêtes plus complexes peuvent nécessiter l’utilisation de SWbemServices.ExecQuery.
Pour obtenir une explication de cette syntaxe, consultez Conventions de document pour l’API de script.
Syntaxe
objWbemObjectSet = .Instances_( _
[ ByVal iFlags ], _
[ ByVal objwbemNamedValueSet ] _
)
Paramètres
-
iFlags [in, facultatif]
-
Entier qui détermine le comportement de l’appel. Ce paramètre peut accepter les valeurs suivantes.
-
wbemFlagForwardOnly (32 (0x20))
-
Provoque le retour d’un énumérateur uniquement vers l’avant. Les énumérateurs de ce type sont généralement beaucoup plus rapides et utilisent moins de mémoire que les énumérateurs conventionnels, mais ils ne permettent pas les appels à SWbemObject.Clone_.
-
wbemFlagBidirectional (0 (0x0))
-
Permet à WMI de conserver les pointeurs vers les objets de l’énumération jusqu’à ce que le client libère l’énumérateur.
-
wbemFlagReturnImmediately (16 (0x10))
-
Valeur par défaut pour ce paramètre. Cet indicateur entraîne le retour immédiat de l’appel.
-
wbemFlagReturnWhenComplete ( 0 (0x0))
-
Provoque le blocage de cet appel jusqu’à ce que la requête soit terminée.
-
wbemQueryFlagShallow (1 (0x1))
-
Force l’énumération à inclure uniquement les sous-classes immédiates de la classe parente spécifiée.
-
wbemQueryFlagDeep (0 (0x0))
-
Valeur par défaut pour ce paramètre. Cette valeur force l’énumération à inclure toutes les classes dans la hiérarchie.
-
wbemFlagUseAmendedQualifiers (131072 (0x20000))
-
Permet à WMI de retourner des données de modification de classe avec la définition de classe de base.
objwbemNamedValueSet [entier, facultatif]
En règle générale, ceci n’est pas défini. Sinon, il s’agit d’un objet SWbemNamedValueSet dont les éléments représentent les informations de contexte qui peuvent être utilisées par le fournisseur répondant à la demande. Un fournisseur qui prend en charge ou requiert de telles informations doit documenter les noms de valeur reconnus, le type de données de la valeur, les valeurs autorisées et la sémantique.
Valeur retournée
Si la méthode réussit, un objet SWbemObjectSet est retourné.
Codes d’erreur
Une fois la méthode Instances_ terminée, l’objet Err peut contenir l’un des codes d’erreur de la liste suivante.
-
wbemErrAccessDenied - 2147749891 (0x80041003)
-
L’utilisateur actuel n’a pas l’autorisation de voir les instances de la classe spécifiée.
-
wbemErrFailed - 2147749889 (0x80041001)
-
Une erreur non spécifiée s’est produite.
-
wbemErrInvalidClass - 2147749904 (0x80041010)
-
La classe spécifiée n’est pas valide.
-
wbemErrInvalidParameter - 2147749896 (0x80041008)
-
Un paramètre spécifié n’est pas valide.
-
wbemErrOutOfMemory - 2147749894 (0x80041006)
-
La mémoire disponible est insuffisante pour terminer cette opération.
Notes
La méthode Instances_ fonctionne uniquement pour les objets de classe. Ce n’est pas une erreur si la collection retournée a zéro élément. Le comportement par défaut de cette méthode est semi-synchrone en raison de la valeur IFlags par défaut wbemFlagReturnImmediately.
Spécifications
| 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_SWbemObject |
| IID |
IID_ISWbemObject |