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.

objwbemNamedValueSet [in, 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 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

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

SWbemObjectSet