Método SWbemServices.ReferencesToAsync
El método ReferencesToAsync del objeto SWbemServices devuelve todas las clases de asociación o instancias que hacen referencia a una instancia o clase de origen específica. Este método realiza la misma función que realiza la consulta de WQL REFERENCES OF.
Para más información sobre el modo asincrónico, vea Llamar a un método.
Para obtener una explicación de esta sintaxis, vea Convenciones de documentación para la API de scripting.
Sintaxis
SWbemServices.ReferencesToAsync( _
ByVal ObjWbemSink, _
ByVal strObjectPath, _
[ ByVal strResultClass ], _
[ ByVal strRole ], _
[ ByVal bClassesOnly ], _
[ ByVal bSchemaOnly ], _
[ 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 del origen para este método. Para más información, vea Localización de información de clases WMI.
-
strResultClass [opcional]
-
Cadena que contiene un nombre de clase. Si se especifica, este parámetro indica que los objetos de asociación devueltos deben pertenecer o derivarse de la clase especificada en este parámetro.
-
strRole [opcional]
-
Cadena que contiene el nombre de la propiedad. Si se especifica, este parámetro indica que los objetos de asociación devueltos deben limitarse a aquellos en los que el objeto de origen desempeña un rol específico. El rol se define mediante el nombre de una propiedad de referencia especificada de una asociación.
-
bClassesOnly [opcional]
-
Valor booleano que indica si se debe devolver o no una lista de nombres de clase en lugar de instancias reales de las clases. Estas son las clases a las que pertenecen los objetos de asociación. El valor predeterminado de este parámetro es FALSE.
-
bSchemaOnly [opcional]
-
Valor booleano que indica si la consulta se aplica o no 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 asociadas a la clase de origen en el esquema.
-
strRequiredQualifier [opcional]
-
Cadena que contiene un nombre de calificador. Si se especifica, este parámetro indica que los objetos de asociació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 wbemFlagBidirectional. Este parámetro puede aceptar los valores siguientes.
-
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 Instrumental de administración de Windows (WMI) devuelva datos de modificación de clase junto con la definición de clase base. Para más información, vea Localización de información de clases 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 requiera información de contexto debe documentar los nombres de valor reconocidos, el tipo de datos del valor, los valores permitidos y la semántica.
objWbemAsyncContext [opcional]
Se trata de un objeto SWbemNamedValueSet que se devuelve al receptor del objeto para identificar el origen de la llamada asincrónica original. Use este parámetro para realizar varias llamadas asincrónicas con 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 ReferencesToAsync, el objeto Err puede contener uno de los códigos de error de la lista siguiente.
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.
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, consulte Establecimiento de la seguridad en una llamada asincrónica.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Encabezado |
|
| Biblioteca de tipos |
|
| Archivo DLL |
|
| CLSID |
CLSID_SWbemServices |
| IID |
IID_ISWbemServices |