Método SWbemServices.AssociatorsOf

El método AssociatorsOf del objeto SWbemServices devuelve una colección de objetos (clases o instancias) denominados puntos de conexión que están asociados a un objeto específico. Este método realiza la misma función que la consulta ASSOCIATORS OF WQL.

Se llama a este método en el modo semisincrónico de forma predeterminada. Para obtener más información, vea Llamada a un método.

Para obtener una explicación de esta sintaxis, vea Convenciones de documentación para la API de scripting.

Sintaxis

objWbemObjectSet = .AssociatorsOf( _
  ByVal strObjectPath, _
  [ ByVal strAssocClass ], _
  [ ByVal strResultClass ], _
  [ ByVal strResultRole ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredAssocQualifier ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

Parámetros

strObjectPath

Necesario. Cadena que contiene la ruta de acceso del objeto de la clase o instancia de origen. Para obtener más información, vea Descripción de la ubicación de un objeto WMI.

strAssocClass [opcional]

Cadena que contiene una clase de asociación. Si se especifica, este parámetro indica que los puntos de conexión devueltos deben estar asociados al origen mediante la clase de asociación especificada o una clase que se deriva de esta clase de asociación.

strResultClass [opcional]

Cadena que contiene un nombre de clase. Si se especifica, este parámetro opcional indica que los puntos de conexión devueltos deben pertenecer a la clase especificada en este parámetro o derivarse de ella.

strResultRole [opcional]

Cadena que contiene el nombre de la propiedad. Si se especifica, este parámetro indica que los puntos de conexión devueltos deben desempeñar un rol determinado en su asociación al objeto de origen. El rol se define mediante el nombre de una propiedad especificada (que debe ser una propiedad de referencia) de una asociación.

strRole [opcional]

Cadena que contiene el nombre de la propiedad. Si se especifica, este parámetro indica que los puntos de conexión devueltos deben participar en una asociación con el objeto de origen en el que el objeto de origen desempeña un rol determinado. El rol se define mediante el nombre de una propiedad especificada (que debe ser una propiedad de referencia) de una asociación.

bClassesOnly [opcional]

Valor booleano que indica si se debe devolver una lista de nombres de clase, en lugar de instancias reales de las clases. Estas son las clases a las que pertenecen las instancias de punto de conexión. El valor predeterminado de este parámetro es FALSE.

bSchemaOnly [opcional]

Valor booleano que indica si la consulta se aplica al esquema, en lugar de a los datos. El valor predeterminado de este parámetro es FALSE. Solo se puede establecer en TRUE si el parámetro strObjectPath especifica el trazado del objeto de una clase. Cuando se establece en TRUE, el conjunto de puntos de conexión devueltos representa las clases que están adecuadamente asociadas a la clase de origen en el esquema.

strRequiredAssocQualifier [opcional]

Cadena que contiene un nombre de calificador. Si se especifica, este parámetro indica que los puntos de conexión devueltos deben estar asociados al objeto de origen mediante una clase de asociación que incluya el calificador especificado.

strRequiredQualifier [opcional]

Cadena que contiene un nombre de calificador. Si se especifica, este parámetro indica que los puntos de conexión devueltos deben incluir el calificador especificado.

iFlags [opcional]

Entero que especifica marcas adicionales para la operación. El valor predeterminado de este parámetro es wbemFlagReturnImmediately, que llama al método en el modo semisincrónico. Este parámetro puede aceptar los valores siguientes.

wbemFlagForwardOnly (32 (0x20))

Provoca la devolución de un enumerador de solo avance. Los enumeradores de solo avance suelen ser mucho más rápidos y usan menos memoria que los enumeradores convencionales, pero no permiten llamadas a SWbemObject.Clone_.

wbemFlagBidirectional (0 (0x0))

Hace que WMI conserve los punteros a objetos de la enumeración hasta que el cliente libere el enumerador.

wbemFlagReturnImmediately (16 (0x10))

Hace que la llamada se devuelva inmediatamente.

wbemFlagReturnWhenComplete (0 (0x0))

Provoca que esta llamada se bloquee hasta que se complete la consulta. Esta marca llama al método en modo sincrónico.

wbemFlagUseAmendedQualifiers (131072 (0x20000))

Hace que WMI devuelva datos de modificación de clase junto con la definición de clase base. Para obtener más información, vea Localización de información de clase WMI.

objwbemNamedValueSet [opcional]

Normalmente, esto no está definido. De lo contrario, se trata de un objeto SWbemNamedValueSet cuyos elementos representan la información de contexto que puede usar el proveedor que atiende la solicitud. Un proveedor que admita o necesite esa información debe documentar los nombres de valor reconocidos, el tipo de datos del valor, los valores permitidos y la semántica.

Valor devuelto

Si la llamada se realiza correctamente, se devolverá un objeto SWbemObjectSet.

Códigos de error

Después de completar el método AssociatorsOf, el objeto Err puede contener uno de los códigos de error de esta lista.

Nota

Una colección devuelta con cero elementos no es un error.

wbemErrAccessDenied: 2147749891 (0x80041003)

El usuario actual no tiene permiso para ver una o varias de las clases devueltas por la llamada.

wbemErrFailed: 2147749889 (0x80041001)

Error no especificado.

wbemErrInvalidParameter: 2147749896 (0x80041008)

Se ha especificado un parámetro no válido.

wbemErrOutOfMemory: 2147749894 (0x80041006)

No hay suficiente memoria para completar la operación.

wbemErrNotFound: 2147749890 (0x80041002)

No se encontró el elemento solicitado.

Comentarios

El método recupera las instancias de los recursos administrados asociados a un recurso especificado mediante una o varias clases de asociación. Proporcione el trazado del objeto para el punto de conexión de origen y AssociatorsOf devolverá los recursos administrados en el punto de conexión opuesto. El método AssociatorsOf realiza la misma función que la consulta WQL ASSOCIATORS OF.

Para obtener más información acerca de la consulta WQL ASSOCIATORS OF, las instancias de origen y los puntos de conexión, vea Instrucción ASSOCIATORS OF.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Encabezado	Wbemdisp.h
Biblioteca de tipos	Wbemdisp.tlb
Archivo DLL	Wbemdisp.dll
CLSID	CLSID_SWbemServices
IID	IID_ISWbemServices

Consulte también

SWbemServices

SWbemObject.Associators_

SWbemObject.AssociatorsAsync_

SWbemServices.AssociatorsOfAsync

SWbemObject.References_

SWbemServices.ReferencesTo