SWbemServices. AssociatorsOf, méthode
La méthode AssociatorsOf de l’objet SWbemServices retourne une collection d’objets (classes ou instances) appelées points de terminaison associés à un objet spécifié. Cette méthode exécute la même fonction que les ASSOCIateurs de la requête WQL.
Cette méthode est appelée par défaut en mode semi-synchrone. 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
objWbemObjectSet = .AssociatorsOf( _
ByVal strObjectPath, _
[ ByVal strAssocClass ], _
[ ByVal strResultClass ], _
[ ByVal strResultRole ], _
[ ByVal strRole ], _
[ ByVal bClassesOnly ], _
[ ByVal bSchemaOnly ], _
[ ByVal strRequiredAssocQualifier ], _
[ ByVal strRequiredQualifier ], _
[ ByVal iFlags ], _
[ ByVal objwbemNamedValueSet ] _
)
Paramètres
-
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. S’il 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 des indicateurs supplémentaires pour l’opération. La valeur par défaut de ce paramètre est wbemFlagReturnImmediately, qui appelle la méthode en mode semi-synchrone. Ce paramètre peut accepter les valeurs suivantes.
-
wbemFlagForwardOnly * * * * (32 (0x20))
-
Entraîne le retour d’un énumérateur avant uniquement. Les énumérateurs avant uniquement sont généralement beaucoup plus rapides et utilisent moins de mémoire que les énumérateurs conventionnels, mais ils n’autorisent pas les appels à SWbemObject. Clone _.
-
wbemFlagBidirectional * * * * (0 (0x0))
-
Fait en sorte que WMI conserve les pointeurs vers les objets de l’énumération jusqu’à ce que le client libère l’énumérateur.
-
wbemFlagReturnImmediately * * * * (16 (0x10))
-
Provoque 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. Cet indicateur appelle la méthode en mode synchrone.
-
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, 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.
Valeur de retour
Si l’appel réussit, un objet SWbemObjectSet est retourné.
Codes d’erreur
À la fin de la méthode AssociatorsOf , l’objet Err peut contenir l’un des codes d’erreur répertoriés dans la liste suivante.
Notes
Une collection retournée avec zéro élément n’est pas une erreur.
-
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
La méthode récupère les instances des ressources managées associées à une ressource spécifiée par le biais d’une ou plusieurs classes d’association. Vous fournissez le chemin d’accès de l’objet pour le point de terminaison d’origine, et AssociatorsOf retourne les ressources managées au point de terminaison opposé. La méthode AssociatorsOf exécute la même fonction que les ASSOCIateurs de la requête WQL.
Pour plus d’informations sur les ASSOCIateurs d’une requête WQL, d’instances source et de points de terminaison, consultez ASSOCIATORS OF Statement.
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 _ SWbemServices |
| IID |
IID _ ISWbemServices |