método SWbemObject.References_

O método References_ do objeto SWbemObject retorna uma coleção de todas as classes de associação ou instâncias que se referem ao objeto atual.

Esse método executa a mesma função que a consulta REFERENCES OF do WQL.

Para obter uma explicação dessa sintaxe, consulte Convenções de documentação para a API de script.

Sintaxe

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

Parâmetros

strResultClass [in, opcional]

Cadeia de caracteres que contém um nome de classe. Se especificado, este parâmetro indica que os objetos de associação retornados devem pertencer à classe especificada neste parâmetro ou serem derivados dela.

strRole [in, opcional]

Cadeia de caracteres que contém um nome de propriedade. Se especificado, esse parâmetro indica que os objetos de associação retornados devem estar restritos àqueles nos quais o objeto de origem desempenha uma função específica. A função é definida pelo nome de uma propriedade especificada (que deve ser uma propriedade de referência) de uma associação.

bClassesOnly [in, opcional]

Valor booliano que indica se uma lista de nomes de classe deve ou não ser retornada em vez das instâncias reais das classes. Essas são as classes às quais os objetos de associação pertencem. O valor padrão para esse parâmetro é FALSE.

bSchemaOnly [in, opcional]

Valor booliano que indica se a consulta se aplica ou não ao esquema em vez dos dados. O valor padrão para esse parâmetro é FALSE. Ele só poderá ser definido como TRUE se o objeto no qual esse método é invocado for uma classe. Quando definido como TRUE, o conjunto de pontos de extremidade retornados representa classes que estão adequadamente associadas à classe de origem no esquema.

strRequiredQualifier [in, opcional]

Cadeia de caracteres que contém um nome de qualificador. Se especificado, esse parâmetro indicará que os objetos de associação retornados devem incluir o qualificador especificado.

iFlags [in, opcional]

Valor inteiro que especifica sinalizadores adicionais para a operação. O padrão para esse parâmetro é wbemFlagReturnImmediately, que direciona a chamada para retornar imediatamente em vez de aguardar até que a consulta seja concluída. Esse parâmetro pode aceitar os valores a seguir.

wbemFlagForwardOnly (32 (0x20))

Faz com que um enumerador somente de encaminhamento seja retornado. Normalmente, os enumeradores apenas de encaminhamento são mais rápidos e usam menos memória do que os enumeradores convencionais, mas eles não permitem chamadas para SWbemObject.Clone_.

wbemFlagBidirectional (0 (0x0))

Faz com que o WMI (Instrumentação de Gerenciamento do Windows) mantenha ponteiros para os objetos da enumeração até que o cliente libere o enumerador.

wbemFlagReturnImmediately (16 (0x10))

Faz com que a chamada retorne imediatamente.

wbemFlagReturnWhenComplete (0 (0x0))

Faz com que essa chamada fique bloqueada até que a consulta seja concluída.

wbemFlagUseAmendedQualifiers (131072 (0x20000))

Faz com que o WMI retorne dados de aditamento da classe com a definição da classe base. Para obter mais informações sobre qualificadores alterados, consulte Localizar informações de classe WMI.

objwbemNamedValueSet [entrada, opcional]

Normalmente, isso é indefinido. Caso contrário, esse será um objeto SWbemNamedValueSet cujos elementos representam as informações de contexto que podem ser usadas pelo provedor que está atendendo à solicitação. Um provedor que dê suporte ou exija essas informações deve documentar os nomes de valor reconhecidos, o tipo de dados do valor, os valores permitidos e a semântica.

Retornar valor

Se a chamada for bem-sucedida, um objeto SWbemObjectSet será retornado.

Códigos do Erro

Após a conclusão do método References_, o objeto Err pode conter um dos códigos de erro da lista a seguir.

wbemErrAccessDenied – 2147749891 (0x80041003)

O usuário atual não tem permissão para exibir uma ou mais das classes retornadas pela função.

wbemErrFailed – 2147749889 (0x80041001)

Erro não especificado.

wbemErrInvalidParameter – 2147749896 (0x80041008)

Foi especificado um parâmetro inválido.

wbemErrOutOfMemory – 2147749894 (0x80041006)

Não há memória suficiente para concluir a operação.

Comentários

Para obter mais informações sobre a consulta WQL “REFERENCES OF” associada, instâncias de origem e objetos de associação, consulte Instrução ASSOCIATORS OF.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Cabeçalho	Wbemdisp.h
Biblioteca de tipos	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject

Confira também

SWbemObject

SWbemObject.Associators_

SWbemServices.AssociatorsOf

SWbemServices.ReferencesTo