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 |
|
| Biblioteca de tipos |
|
| DLL |
|
| CLSID |
CLSID_SWbemObject |
| IID |
IID_ISWbemObject |