Método SWbemObject.References_

El método References_ del objeto SWbemObject devuelve una colección de todas las clases de asociación o instancias que hacen referencia al objeto actual.

Este método realiza la misma función que la consulta REFERENCES OF WQL.

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

Sintaxis

objWbemObjectSet = .References_( _
  [ ByVal strResultClass ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

Parámetros

strResultClass [entrada, 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 [in, optional]

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 especificada (que debe ser una propiedad de referencia) de una asociación.

bClassesOnly [in, optional]

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 [in, optional]

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 objeto en el que se invoca este método es 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.

strRequiredQualifier [in, optional]

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 [entrada, opcional]

Entero que especifica indicadores adicionales para la operación. El valor predeterminado de este parámetro es wbemFlagReturnImmediately, que dirige la llamada para que se devuelva inmediatamente en lugar de esperar a que se complete la consulta. 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 Instrumental de administración de Windows (WMI) conserve 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.

wbemFlagUseAmendedQualifiers (131072 (0x20000))

Hace que WMI devuelva datos de modificación de clase con la definición de clase base. Para obtener más información sobre los calificadores modificados, consulte Localizar información de clase WMI.

objwbemNamedValueSet [in, optional]

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 References_, el objeto Err puede contener uno de los códigos de error de la lista siguiente.

wbemErrAccessDenied - 2147749891 (0x80041003)

El usuario 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

Para más información sobre la consulta WQL REFERENCES OF asociada, las instancias de origen y los objetos de asociación, consulte 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_SWbemObject
IID	IID_ISWbemObject

Consulte también

SWbemObject

SWbemObject.Associators_

SWbemServices.AssociatorsOf

SWbemServices.ReferencesTo