Método SWbemObject.Subclasses_

O método Subclasses_ do objeto SWbemObject retorna um objeto SWbemObjectSet. Esse objeto é uma coleção de subclasses do objeto atual, que deve ser uma classe. Os itens na coleção retornada podem ser obtidos usando métodos de coleção padrão. Para obter mais informações, consulte Acessar uma coleção.

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

Sintaxe

objWbemObjectSet = .Subclasses_( _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

Parâmetros

iFlags [in, opcional]

Inteiro que determina o quão detalhadamente a chamada enumera. Esse parâmetro pode aceitar os valores a seguir.

wbemQueryFlagDeep (0 (0x0))

Força a enumeração recursiva em todas as subclasses derivadas da classe pai especificada. A própria classe pai não é retornada na enumeração.

wbemQueryFlagShallow (1 (0x1))

O valor padrão deste parâmetro. Força a enumeração a incluir apenas subclasses imediatas da classe pai especificada.

WbemFlagReturnImmediately (16 (0x10))

Faz com que a chamada retorne imediatamente

wbemFlagReturnWhenComplete (0 (0x0))

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

wbemFlagUseAmendedQualifiers (131072 (0x20000))

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

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 Subclasses_, 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.

wbemErrInvalidClass – 2147749904 (0x80041010)

A classe especificada não existia.

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

Não é um erro a coleção retornada ter zero elementos se não houver subclasses do objeto atual. O método Subclasses_ funciona apenas para objetos de classe.

Requisitos

Confira também

SWbemObject

SWbemObjectSet