Méthode SWbemObject.Instances_

Article
07/03/2023

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	Wbemdisp.h
Bibliothèque de types	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject

Voir aussi

SWbemObject
SWbemObjectSet