Méthode SWbemObject.ReferencesAsync_
La méthode ReferencesAsync_ de SWbemObject fournit une collection de toutes les classes d’association ou instances qui font référence à l’objet actuel. Cette méthode remplit la même fonction que la requête WQL REFERENCES OF.
Pour obtenir une explication de cette syntaxe, consultez Conventions de document pour l’API de script.
Syntaxe
SWbemObject.ReferencesAsync_( _
ByVal objWbemSink, _
[ ByVal strResultClass ], _
[ ByVal strRole ], _
[ ByVal bClassesOnly ], _
[ ByVal bSchemaOnly ], _
[ ByVal strRequiredQualifier ], _
[ ByVal iFlags ], _
[ ByVal objwbemNamedValueSet ], _
[ ByVal objWbemAsyncContext ] _
)
Paramètres
-
objWbemSink [in]
-
Obligatoire. Récepteur d’objets qui reçoit les objets de façon asynchrone.
-
strResultClass [in, facultatif]
-
Chaîne qui contient un nom de classe. S'il est spécifié, ce paramètre indique que les objets d'association renvoyés doivent appartenir à la classe spécifiée dans ce paramètre ou en être dérivés.
-
strRole [in, 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 nom d’une propriété de référence spécifiée définit le rôle d’une association.
-
bClassesOnly [in, 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 appartiennent les objets d’association. La valeur par défaut de ce paramètre est FALSE.
-
bSchemaOnly [in, facultatif]
-
Valeur booléenne indiquant 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 être définie sur TRUE que si l’objet sur lequel cette méthode est appelée est une classe. Lorsque la valeur est TRUE, l'ensemble des points d'extrémité renvoyés représente les classes qui sont convenablement associées à la classe source dans le schéma.
-
strRequiredQualifier [in, 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 [in, facultatif]
-
Entier spécifiant des indicateurs supplémentaires à l’opération. Ce paramètre peut accepter les valeurs suivantes.
-
wbemFlagSendStatus (128 (0x80))
-
Provoque des appels asynchrones pour envoyer 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 de l’état du récepteur d’objets au gestionnaire d’événements OnProgress.
-
wbemFlagUseAmendedQualifiers (131072 (0x20000))
-
Entraîne le retour des données de modification de classe par Windows Management Instrumentation (WMI) avec la définition de classe de base. Pour plus d’informations, voir Localisation des informations de classe WMI.
objwbemNamedValueSet [in, facultatif]
En règle générale, ce 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 exige de telles informations doit documenter les noms des valeur reconnues, le type de données de la valeur, les valeurs autorisées et la sémantique.
objWbemAsyncContext [in, 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 de l’objet et la source de l’appel peut être extraite à l’aide de la méthode SWbemNamedValueSet.Item. Pour plus d’informations, voir Appeler 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 ReferencesAsync_ 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 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)
-
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 de rappels remis au récepteur spécifié dans objWbemSink. Pour traiter chaque objet lorsqu’il arrive, 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 pose des risques de sécurité pour vos scripts et applications. Pour éliminer les risques, utilisez la communication semi-synchronisée ou la communication synchrone. Pour plus d’informations, voir Appeler une méthode.
Pour plus d’informations sur la requête WQL associée REFERENCES OF, les instances sources et les objets d’association, voir Instruction ASSOCIATORS OF.
Spécifications
| 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 |