Método SWbemObject.Associators_

O método Associators_ do objeto SWbemObject retorna uma coleção de objetos (classes ou instâncias) associados ao objeto atual. Esses objetos retornados são chamados de pontos de extremidade. Esse método executa a mesma função que a consulta WQL ASSOCIATORS OF.

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

Sintaxe

objWbemObjectSet = .Associators_( _
  [ ByVal strAssocClass ], _
  [ ByVal strResultClass ], _
  [ ByVal strResultRole ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredAssocQualifier ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

Parâmetros

strAssocClass [entrada, opcional]

Cadeia de caracteres que contém uma classe de associação. Se especificado, esse parâmetro indicará que os pontos de extremidade retornados devem ser associados à origem por meio da classe de associação especificada ou de uma classe derivada dessa classe de associação.

strResultClass [entrada, opcional]

Cadeia de caracteres que contém um nome de classe. Se especificado, este parâmetro indicará que os pontos de extremidade retornados devem pertencer à classe especificada neste parâmetro ou serem derivados dela.

strResultRole [entrada, opcional]

Cadeia de caracteres que contém um nome de propriedade. Se especificado, esse parâmetro indicará que os pontos de extremidade retornados devem desempenhar uma função específica na associação com o objeto de origem. A função é definida pelo nome de uma propriedade especificada (que deve ser uma propriedade de referência) de uma associação.

strRole [entrada, opcional]

Cadeia de caracteres que contém um nome de propriedade. Se especificado, esse parâmetro indicará que os pontos de extremidade retornados devem participar de uma associação com o objeto de origem no qual 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 [entrada, opcional]

Valor booliano que indica se uma lista de nomes de classe deve ser retornada no lugar das instâncias reais das classes. Essas são as classes às quais as instâncias de ponto de extremidade pertencem. O valor padrão para esse parâmetro é FALSE.

bSchemaOnly [entrada, opcional]

Esse é um valor booliano que indica se a consulta se aplica 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 representará classes que estão adequadamente associadas à classe de origem no esquema.

strRequiredAssocQualifier [entrada, opcional]

Cadeia de caracteres que contém um nome de qualificador. Esse parâmetro, se especificado, indicará que os pontos de extremidade retornados devem ser associados ao objeto de origem por meio de uma classe de associação que inclui o qualificador especificado.

strRequiredQualifier [entrada, opcional]

Cadeia de caracteres que contém um nome de qualificador. Esse parâmetro, se especificado, indicará que os pontos de extremidade retornados devem incluir o qualificador especificado.

iFlags [entrada, 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 a WMI retenha ponteiros para 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. A inclusão desse sinalizador disponibiliza o texto do qualificador de descrição localizado para classes, propriedades e métodos. Para obter mais informações sobre qualificadores alterados, confira Localizar informações de classe do 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 Associators_, o objeto Err poderá 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)

Um parâmetro especificado não é válido.

wbemErrOutOfMemory - 2147749894

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

Comentários

Para obter mais informações sobre as consultas WQL associadas ASSOCIATORS OF, as instâncias de origem e os pontos de extremidade, confira 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.References_

SWbemServices.AssociatorsOf

SWbemServices.ReferencesTo