SWbemServices. AssociatorsOfAsync, méthode

La méthode AssociatorsOfAsync de l’objet SWbemServices retourne une collection d’objets (classes ou instances) appelées points de terminaison associés à un objet spécifié. L’appel à AssociatorsOfAsync retourne immédiatement, et les résultats et l’État sont retournés à l’appelant via des événements remis au récepteur spécifié dans objWbemSink. Pour gérer chaque objet retourné, créez un objWbemSink. Gestionnaire d’événements OnObjectReady .

Une fois que tous les objets arrivent, le traitement s’effectue dans le objWbemSink. Événement OnCompleted . Cette méthode exécute la même fonction que les ASSOCIateurs de la requête WQL. Pour plus d’informations sur la création d’un récepteur, consultez réception d’un événement WMI.

La méthode est appelée en mode asynchrone. Pour plus d’informations, consultez appel d’une méthode.

Pour une explication de cette syntaxe, consultez conventions de document pour l’API de script.

Syntaxe

SWbemServices.AssociatorsOfAsync( _
  ByVal objWbemSink, _
  ByVal strObjectPath, _
  [ ByVal strAssocClass ], _
  [ ByVal strResultClass ], _
  [ ByVal strResultRole ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredAssocQualifier ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Paramètres

objWbemSink

Obligatoire. Récepteur d’objets qui reçoit les objets de manière asynchrone. Créez un objet SWbemSink pour recevoir les objets.

strObjectPath

Obligatoire. Chaîne qui contient le chemin d’accès de l’objet de la classe ou de l’instance source. Pour plus d’informations, consultez Description de l’emplacement d’un objet WMI.

strAssocClass [ facultatif]

Chaîne qui contient une classe d’association. Quand ce paramètre est spécifié, ce paramètre indique que les points de terminaison retournés doivent être associés à la source par le biais de la classe d’association spécifiée ou d’une classe dérivée de cette classe d’association.

strResultClass [ facultatif]

Chaîne qui contient un nom de classe. S’il est spécifié, ce paramètre facultatif indique que les points de terminaison retournés doivent appartenir ou être dérivés de la classe spécifiée dans ce paramètre.

strResultRole [ facultatif]

Chaîne qui contient un nom de propriété. S’il est spécifié, ce paramètre indique que les points de terminaison retournés doivent jouer un rôle particulier dans leur association avec l’objet source. Le rôle est défini par le nom d’une propriété spécifiée (qui doit être une propriété de référence) d’une association.

strRole [ facultatif]

Chaîne qui contient un nom de propriété. Si ce paramètre est spécifié, ce paramètre indique que les points de terminaison retournés doivent participer à une association avec l’objet source dans lequel l’objet source joue un rôle particulier. Le rôle est défini par le nom d’une propriété spécifiée (qui doit être une propriété de référence) d’une association.

bClassesOnly [ facultatif]

Valeur booléenne qui indique si une liste de noms de classes doit être retournée plutôt que des instances réelles des classes. Il s’agit des classes auxquelles les instances de point de terminaison appartiennent. La valeur par défaut de ce paramètre est false.

bSchemaOnly [ facultatif]

Valeur booléenne qui indique si la requête s’applique au schéma plutôt qu’aux données. La valeur par défaut de ce paramètre est false. Elle ne peut avoir la valeur true que si le paramètre strObjectPath spécifie le chemin d’accès à l’objet d’une classe. Quand la valeur est true, le jeu de points de terminaison retournés représente des classes qui sont associées correctement à la classe source dans le schéma.

strRequiredAssocQualifier [ facultatif]

Chaîne qui contient un nom de qualificateur. Si ce paramètre est spécifié, ce paramètre indique que les points de terminaison retournés doivent être associés à l’objet source par le biais d’une classe d’association qui inclut le qualificateur spécifié.

strRequiredQualifier [ facultatif]

Chaîne qui contient un nom de qualificateur. S’il est spécifié, ce paramètre indique que les points de terminaison retournés doivent inclure le qualificateur spécifié.

IFlags [ facultatif]

Entier qui spécifie les indicateurs supplémentaires pour l’opération. La valeur par défaut de ce paramètre est wbemFlagDontSendStatus. 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 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 des données de modification de classe avec la définition de la classe de base. Pour plus d’informations sur les qualificateurs modifiés, consultez localisation des informations de classe WMI.

objWbemNamedValueSet [ 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 [ facultatif]

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 de retour

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 AssociatorsOfAsync , 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’a pas l’autorisation d’afficher une ou plusieurs des classes retournées par l’appel.

wbemErrFailed -2147749889 (0x80041001)

Erreur non spécifiée.

wbemErrInvalidParameter -2147749896 (0x80041008)

Un paramètre non valide a été spécifié.

wbemErrOutOfMemory -2147749894 (0x80041006)

Mémoire insuffisante pour terminer l’opération.

wbemErrNotFound -2147749890 (0x80041002)

L’élément demandé est introuvable.

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 retourne, 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, consultez définition de la sécurité sur un appel asynchrone.

Utilisez le paramètre objWbemAsyncContext dans les scripts pour vérifier la source d’un appel.

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 _ SWbemServices
IID
IID _ ISWbemServices

Voir aussi

M

SWbemObject. ASSOCIATORS_

SWbemObject. AssociatorsAsync_

SWbemObject. References_

SWbemObject. ReferencesAsync_

SWbemServices. ReferencesTo

SWbemServices. ReferencesToAsync