Método SWbemObject.Instances_

O método Instances_ do objeto SWbemObject cria um enumerador que retorna as instâncias do objeto de classe atual. Esse método implementa uma consulta simples. Consultas mais complexas podem exigir o uso de SWbemServices.ExecQuery.

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

Sintaxe

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

Parâmetros

iFlags [in, opcional]

Inteiro que determina o comportamento da chamada. 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))

O valor padrão deste parâmetro. Esse sinalizador faz com que a chamada retorne imediatamente.

wbemFlagReturnWhenComplete ( 0 (0x0))

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

wbemQueryFlagShallow (1 (0x1))

Força a enumeração a incluir apenas subclasses imediatas da classe pai especificada.

wbemQueryFlagDeep (0 (0x0))

Padrão desse parâmetro. Esse valor força a enumeração a incluir todas as classes na hierarquia.

wbemFlagUseAmendedQualifiers (131072 (0x20000))

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

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

Códigos do Erro

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

wbemErrAccessDenied - 2147749891 (0x80041003)

O usuário atual não tem permissão para visualizar instâncias da classe especificada.

wbemErrFailed - 2147749889 (0x80041001)

Ocorreu um erro não especificado.

wbemErrInvalidClass – 2147749904 (0x80041010)

A classe especificada não é válida.

wbemErrInvalidParameter – 2147749896 (0x80041008)

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

wbemErrOutOfMemory – 2147749894 (0x80041006)

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

Comentários

O método Instances_ só funciona para objetos de classe. Não é um erro que a coleção retornada não tenha elementos. O comportamento padrão para esse método é semissíncrono devido ao valor de IFlagspadrão wbemFlagReturnImmediately.

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