SWbemObject. instances, _ méthode
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. Les requêtes plus complexes peuvent nécessiter l’utilisation de SWbemServices.ExecQuery.
Pour une explication de cette syntaxe, consultez conventions de document pour l’API de script.
Syntaxe
objWbemObjectSet = .Instances_( _
[ ByVal iFlags ], _
[ ByVal objwbemNamedValueSet ] _
)
Paramètres
-
IFlags [ dans, facultatif]
-
Entier qui détermine le comportement de l’appel. Ce paramètre peut accepter les valeurs suivantes.
-
wbemFlagForwardOnly * * * * (32 (0x20))
-
Entraîne le retour d’un énumérateur avant uniquement. Les énumérateurs avant uniquement sont généralement beaucoup plus rapides et utilisent moins de mémoire que les énumérateurs conventionnels, mais ils n’autorisent pas les appels à SWbemObject. Clone _.
-
wbemFlagBidirectional * * * * (0 (0x0))
-
Fait en sorte que WMI conserve 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 force l’appel à retourner immédiatement.
-
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))
-
Fait en sorte que WMI retourne des données de modification de classe avec la définition de classe de base.
objwbemNamedValueSet [ dans, facultatif]
En général, ce n’est pas défini. Dans le cas contraire, 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 qui traite la requête. Un fournisseur qui prend en charge ou requiert ces 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 retourne.
Codes d’erreur
Une fois la méthode instances _ terminée, l’objet Err peut contenir l’un des codes d’erreur répertoriés dans la liste suivante.
-
wbemErrAccessDenied -2147749891 (0x80041003)
-
L’utilisateur actuel n’est pas autorisé à afficher 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)
-
Mémoire insuffisante pour terminer l’opération.
Remarques
La méthode _ instances fonctionne uniquement pour les objets de classe. Il n’y a pas d’erreur pour que la collection retournée n’ait aucun élément. Le comportement par défaut de cette méthode est semi-synchrone en raison de la valeur IFlags par défaut wbemFlagReturnImmediately.
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 _ SWbemObject |
| IID |
IID _ ISWbemObject |