Método SWbemServices.ReferencesTo

O método ReferencesTo do objeto SWbemServices retorna uma coleção de todas as classes de associação ou instâncias que se referem a uma classe ou instância de origem específica. Esta função realiza a mesma operação que a consulta WQL REFERENCES OF executa.

Esse método é chamado no modo semissíncrono. Para obter mais informações, consulte Chamar um método.

Para conferir uma explicação dessa sintaxe, confira Convenções de documentação para API de script.

Sintaxe

objWbemObjectSet = .ReferencesTo( _
  ByVal strObjectPath, _
  [ ByVal strResultClass ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ] _
)

Parâmetros

strObjectPath

Obrigatórios. Cadeia de caracteres que contém o caminho do objeto da origem desse método. Para obter mais informações, confira Descrever o local de um objeto do WMI.

strResultClass [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 [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 [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 [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 parâmetro strObjectPath especificar o caminho do objeto de 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 [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 [opcional]

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 seja bloqueada até que a consulta seja concluída. Esse sinalizador chama o método no modo síncrono.

wbemFlagUseAmendedQualifiers (131072 (0x20000))

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

objWbemNamedValueSet [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 o método for bem-sucedido, o método retornará um objeto SWbemObjectSet.

Códigos do Erro

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

Observação

Uma coleção retornada sem elementos não é um erro.

wbemErrAccessDenied – 2147749891 (0x80041003)

O usuário atual não tem a 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.

wbemFlagUseAmendedQualifiers - 131072 (0x20000)

Faz com que o WMI retorne dados de aditamento da classe com a definição da classe base.

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_SWbemServices
IID	IID_ISWbemServices

Confira também

SWbemServices

SWbemObject.Associators_

SWbemObject.References_

SWbemServices.AssociatorsOf