SWbemObject. InstancesAsync, _ méthode

La méthode _ InstancesAsync de SWbemObject fournit de manière asynchrone 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

SWbemObject.InstancesAsync_( _
  ByVal objWbemSink, _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Paramètres

objWbemSink [ dans]

Récepteur d’objets qui retourne les instances.

IFlags [ dans, facultatif]

Entier qui détermine le comportement de l’appel. Ce paramètre peut accepter les valeurs suivantes.

wbemFlagSendStatus * * * * (128 (0x80))

Fait en sorte que les appels asynchrones envoient des mises à jour d’État au gestionnaire d’événements SWbemSink. OnProgress pour le récepteur d’objets.

wbemFlagDontSendStatus * * * * (0 (0x0))

Empêche les appels asynchrones d’envoyer des mises à jour d’État au gestionnaire d’événements OnProgress pour le récepteur d’objets.

wbemFlagUseAmendedQualifiers * * * * (131072 (0x20000))

Fait en sorte que WMI retourne les descriptions des propriétés et des classes localisées. Pour plus d’informations, consultez localisation des informations de classe WMI.

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.

objWbemAsyncContext [ dans, facultatif]

Il s’agit d’un objet SWbemNamedValueSet qui retourne au récepteur d’objets pour identifier la source de l’appel asynchrone d’origine. Utilisez ce paramètre si vous effectuez plusieurs appels asynchrones à l’aide du même récepteur d’objets. Pour utiliser ce paramètre, créez un objet SWbemNamedValueSet et utilisez la méthode SWbemNamedValueSet. Add pour ajouter une valeur qui identifie l’appel asynchrone que vous effectuez. Cet objet SWbemNamedValueSet est retourné au récepteur d’objets et la source de l’appel peut être extraite à l’aide de la méthode SWbemNamedValueSet. Item . Pour plus d’informations, consultez appel d’une méthode.

Valeur retournée

Cette méthode ne retourne pas de valeur. En cas de réussite, le récepteur reçoit un événement OnObjectReady par instance. Après la dernière instance, le récepteur d’objets reçoit un événement OnCompleted .

Codes d’erreur

À la fin de la méthode _ InstancesAsync , 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.

Notes

Cet appel est retourné immédiatement. Les objets et l’État demandés sont retournés à l’appelant via des rappels remis au récepteur spécifié dans objWbemSink. Pour traiter chaque objet lorsqu’il arrive, créez un objWbemSink. Sous-routine d’événement OnObjectReady . Une fois que tous les objets sont retournés, vous pouvez effectuer le traitement final dans votre implémentation de objWbemSink. Événement OnCompleted .

Un rappel asynchrone permet à un utilisateur non authentifié de fournir des données au récepteur. Cela pose des risques de sécurité pour vos scripts et vos applications. Pour éliminer les risques, utilisez une communication semi-synchrone ou une communication synchrone. Pour plus d’informations, consultez appel d’une méthode.

La méthode _ InstancesAsync fonctionne uniquement pour les objets de classe. Il n’y a pas d’erreur pour que la collection retournée ait des éléments nuls (0).

Configuration requise

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

M

SWbemObjectSet