Método SWbemServices.AssociatorsOfAsync

El método AssociatorsOfAsync 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. La llamada a AssociatorsOfAsync se devuelve inmediatamente, y los resultados y el estado se devuelven al autor de la llamada mediante eventos que se entregan al receptor especificado en objWbemSink. Para controlar cada objeto devuelto, cree un controlador de eventos objWbemSink.OnObjectReady.

Una vez que han llegado todos los objetos, el procesamiento se realiza en el evento objWbemSink.OnCompleted. Este método realiza la misma función que la consulta ASSOCIATORS OF WQL. Para obtener más información sobre cómo crear un receptor, vea Recepción de un evento WMI.

Se llama al método en el modo asincrónico. Para 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

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 ] _
)

Parámetros

objWbemSink

Necesario. Receptor de objetos que recibe los objetos de forma asincrónica. Cree un objeto SWbemSink para recibir los objetos.

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. Cuando se especifica, este parámetro indica que los puntos de conexión devueltos deben estar asociados con el origen mediante la clase de asociación especificada o una clase derivada 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 las marcas adicionales para la operación. El valor predeterminado de este parámetro es wbemFlagDontSendStatus. Este parámetro puede aceptar los siguientes valores.

wbemFlagSendStatus (128 (0x80))

Hace que las llamadas asincrónicas envíen actualizaciones de estado al controlador de eventos OnProgress para el receptor de objetos.

wbemFlagDontSendStatus (0 (0x0))

Impide que las llamadas asincrónicas envíen actualizaciones de estado al controlador de eventos OnProgress para el receptor de objetos.

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 sobre los calificadores modificados, 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.

objWbemAsyncContext [opcional]

Objeto SWbemNamedValueSet que se devuelve al receptor del objeto para identificar el origen de la llamada asincrónica original. Use este parámetro si va a realizar varias llamadas asincrónicas mediante el mismo receptor de objetos. Para usar este parámetro, cree un objeto SWbemNamedValueSet y use el método SWbemNamedValueSet.Add para agregar un valor que identifique la llamada asincrónica que realiza. Este objeto SWbemNamedValueSet se devuelve al receptor del objeto y el origen de la llamada se puede extraer mediante el método SWbemNamedValueSet.Item. Para más información, vea Llamada a un método.

Valor devuelto

Este método no devuelve ningún valor. Si se ejecuta correctamente, el receptor recibe un evento OnObjectReady por cada instancia. Después de la última instancia, el receptor del objeto recibe un evento OnCompleted.

Códigos de error

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

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

Esta llamada devuelve inmediatamente. Los objetos y el estado solicitados se devuelven al autor de la llamada mediante devoluciones de llamada entregadas al receptor especificado en objWbemSink. Para procesar cada objeto cuando se devuelva, cree una subrutina de eventos objWbemSink.OnObjectReady. Una vez que se devuelven todos los objetos, puede realizar el procesamiento final en la implementación del evento objWbemSink.OnCompleted.

Una devolución de llamada asincrónica permite a un usuario no autenticado proporcionar datos al receptor. Esto supone riesgos de seguridad para los scripts y las aplicaciones. Para eliminar los riesgos, vea Establecimiento de la seguridad en una llamada asincrónica.

Use el parámetro objWbemAsyncContext en scripts para comprobar el origen de una llamada.

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_

SWbemObject.References_

SWbemObject.ReferencesAsync_

SWbemServices.ReferencesTo

SWbemServices.ReferencesToAsync