SWbemServices.ReferencesToAsync, méthode

La méthode ReferencesToAsync de l’objet SWbemServices retourne toutes les classes ou instances d’association qui référencent une instance ou classe source spécifique. Cette méthode exécute la même fonction que la requête WQL REFERENCES OF.

Pour plus d’informations sur le mode asynchrone, consultez Appel d’une méthode.

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

Syntaxe

SWbemServices.ReferencesToAsync( _
  ByVal ObjWbemSink, _
  ByVal strObjectPath, _
  [ ByVal strResultClass ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Paramètres

ObjWbemSink

Obligatoire. Récepteur d’objets qui reçoit les objets de façon asynchrone. Créez un objet SWbemSink où recevoir les objets.

strObjectPath

Obligatoire. Chaîne qui contient le chemin de l’objet de la source pour cette méthode. Pour plus d’informations, consultez Localisation des informations de classe WMI.

strResultClass [facultatif]

Chaîne contenant un nom de classe. S’il est spécifié, ce paramètre indique que les objets d’association retournés doivent appartenir à la classe spécifiée dans ce paramètre ou en être dérivés.

strRole [facultatif]

Chaîne contenant le nom de la propriété. S’il est spécifié, ce paramètre indique que les objets d’association retournés doivent être limités à ceux dans lesquels l’objet source joue un rôle spécifique. Le rôle est défini par le nom d’une propriété de référence spécifiée d’une association.

bClassesOnly [facultatif]

Valeur booléenne qui indique si une liste de noms de classes doit être retournée à la place des instances réelles des classes. Il s’agit des classes auxquelles appartiennent les objets d’association. La valeur par défaut de ce paramètre est FALSE.

bSchemaOnly [facultatif]

Valeur booléenne qui indique si la requête s’applique ou non au schéma et pas aux données. La valeur par défaut de ce paramètre est FALSE. La valeur peut être définie sur TRUE seulement si le paramètre strObjectPath spécifie le chemin des objets d’une classe. Lorsque la valeur est TRUE, l’ensemble des points de terminaison retournés représente les classes qui sont associées à la classe source dans le schéma.

strRequiredQualifier [facultatif]

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

iFlags [facultatif]

Entier qui spécifie des indicateurs supplémentaires pour l’opération. La valeur par défaut de ce paramètre est wbemFlagBidirectional. Ce paramètre accepte les valeurs suivantes.

wbemFlagSendStatus (128 (0x80))

Provoque des appels asynchrones pour envoyer des mises à jour de l’état du récepteur d’objets au gestionnaire d’événements OnProgress.

wbemFlagDontSendStatus (0 (0x0))

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

wbemFlagUseAmendedQualifiers (131072 (0x20000))

Spécifie que Windows Management Instrumentation (WMI) doit retourner les données de modification de classe avec la définition de classe de base. Pour plus d’informations, consultez Localisation des informations de classe WMI.

objWbemNamedValueSet [facultatif]

En règle générale, ceci n’est pas défini. Quand elle est définie, la valeur est un objet SWbemNamedValueSet dont les éléments représentent les informations de contexte qui peuvent être utilisées par le fournisseur traitant la requête. Un fournisseur qui prend en charge ou nécessite de telles informations de contexte 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 est retourné au récepteur d’objets pour identifier la source de l’appel asynchrone d’origine. Utilisez ce paramètre pour effectuer plusieurs appels asynchrones au moyen 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

Une fois la méthode ReferencesToAsync terminée, l’objet Err peut contenir l’un des codes d’erreur de la liste suivante.

Notes

Une collection retournée qui ne contient aucun élément n’est pas une erreur.

wbemErrAccessDenied - 2147749891 (0x80041003)

L’utilisateur actuel n’a pas l’autorisation de voir 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)

La mémoire disponible est insuffisante pour terminer cette opération.

Notes

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

Un rappel asynchrone permet à un utilisateur non authentifié de fournir des données au récepteur. Cela présente des risques quant à la sécurité de vos scripts et applications. Pour éliminer ces risques, consultez Configuration de la sécurité sur un appel asynchrone.

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_SWbemServices
IID	IID_ISWbemServices

Voir aussi

SWbemServices

SWbemObject.Associators_

SWbemObject.References_

SWbemServices.AssociatorsOf