Recuperando uma classe WMI

O primeiro tipo de objeto que você pode recuperar é uma classe WMI. Ao recuperar uma classe WMI, você realmente recupera uma definição de classe, que é uma listagem das propriedades, qualificadores e métodos que descrevem totalmente a classe. No entanto, uma definição de classe é basicamente a própria classe.

O PowerShell usa uma consulta padrão para recuperar definições de classe, usando a classe meta_class.

Para recuperar uma definição de classe no PowerShell

• Use o Get-WmiObject com uma consulta para meta_class, com a cláusula WHERE que contém o nome da classe com a qual você deve recuperar.

  Get-WmiObject -query "SELECT * FROM meta_class WHERE __class = 'Win32_LogicalDisk'"
  

  O Get-WmiObject é o cmdlet padrão que o PowerShell usa para recuperar informações de classe e instância do WMI. A classe meta_class define a consulta como uma consulta de esquema. Sem a classe meta_class, essa consulta retornaria todas as instâncias de Win32_LogicalDisk. Para obter mais informações sobre como consultar o WMI, consulte Instrução SELECT para consultas de esquema.

O processo atual para recuperar uma definição de WMI em C# é usar a classe CIMInstance.

Para recuperar uma definição de classe em C# (Microsoft.Management.Infrastructure)

1. Usando o namespace Microsoft.Management.Infrastructure, crie uma classe CIMInstance com o namespace e o nome da classe especificados.

   A classe criada conterá todas as informações de classe, mas nenhum dado de instância.

   using Microsoft.Management.Infrastructure;
   ...
   string Namespace = @"root\cimv2";
   string className = "Win32_LogicalDisk";
   
   CimInstance diskDrive = new CimInstance(className, Namespace);
   

2. Como alternativa, como no PowerShell, você também pode executar uma consulta usando a marca de meta_class como parte da consulta.

   using Microsoft.Management.Infrastructure;
   ...
   string Namespace = @"root\cimv2";
   string diskDriveQuery = "SELECT * FROM meta_class WHERE __class = 'Win32_LogicalDisk'";
   
   CimSession mySession = CimSession.Create("localhost");
   IEnumerable<CimInstance> queryInstance = mySession.QueryInstances(Namespace, "WQL", diskDriveQuery);
   

Assim como acontece com o PowerShell, o C# usa uma consulta de meta_class para recuperar definições de classe. Como alternativa, crie um objeto ManagementClass para acessar a definição de classe diretamente.

Para recuperar uma definição de classe em C# (System.Management)

1. Use o ManagementObjectSerarcher com uma consulta para meta_class, com a cláusula WHERE que contém o nome da classe com a qual você deve recuperar.

   using System.Management;
   ...
   ManagementObjectSearcher searcher = new ManagementObjectSearcher("SELECT * FROM meta_class WHERE __class = 'Win32_LogicalDisk'");
   ManagementObjectCollection myDiskCollection = searcher.Get();
   

   O ManagementObjectSerarcher é a classe padrão que o .NET usa para recuperar informações de classe e instância do WMI. O ManagementObjectSerarcher.Get retorna um ManagementObjectCollection que contém a classe de definição de esquema. A classe meta_class define a consulta como uma consulta de esquema. Sem a classe meta_class, essa consulta retornaria todas as instâncias de Win32_LogicalDisk. Para obter mais informações sobre como consultar o WMI, consulte Instrução SELECT para consultas de esquema.

2. Como alternativa, crie um novo objeto ManagementClass, com o nome como o caminho, para recuperar a classe.

   using System.Management;
   ...
   ManagementClass objInst = new ManagementClass("Win32_LogicalDisk");
   

Recupere uma definição de classe no VBScript de maneira semelhante à recuperação de uma instância específica.

Para recuperar uma definição de classe no VBScript

1. Chame SWbemServices.Get, mas não identifique uma instância específica no caminho do objeto para a classe.

2. O exemplo de código a seguir recupera a definição de classe para a classe que descreve unidades lógicas em seu computador.

   Set objinst = GetObject("WinMgmts:Win32_LogicalDisk")
   

   O WSH (Host de Script do Windows) também dá suporte ao seguinte.

   <OBJECT id="myLocator" progid="WbemScripting.SWbemLocator"></OBJECT>
   

   Em ASP (Active Server Pages) use GetObject ou CreateObject no script do lado do servidor. Para obter mais informações, consulte Criar páginas de servidor ativo para o WMI.

3. Uma classe ou instância também pode ser especificada, nesse caso, o objeto retornado é um objeto do WMI, por exemplo, uma instância de Win32_LogicalDisk, em vez de um objeto de serviços. Observe que não é possível usar as funções GetObject do VBScript para criar uma instância do objeto genérico SWbemObject.

4. Em páginas HTML em execução no IE (Microsoft Internet Explorer), o GetObject e o CreateObject podem falhar porque objetos de script do WMI, como controles ActiveX, não são marcados como seguros para scripts. A única exceção é o objeto SWbemDateTime. A única maneira de essas chamadas serem bem-sucedidas é quando você reduz as configurações de segurança do IE, o que não é recomendado.

Ao recuperar uma classe em C++, chame a versão IWbemServices de GetObject.

Para recuperar uma definição de classe no C++

1. Chame os métodos IWbemServices::GetObject ou IWbemServices::GetObjectAsync para recuperar a definição de uma classe.
2. Uma classe pode ter várias definições de classe, o que acontece normalmente quando você tem mais de um provedor de classe carregado em um namespace. Quando uma classe tem várias definições de classe, o WMI retorna a primeira definição descoberta e o código de status WBEM_S_DUPLICATE_OBJECTS.

Como GetObject retorna uma definição de classe, ela é comumente usada como a primeira etapa na criação de uma instância. Para obter mais informações sobre como usar o GetObject, consulte Criar e declarar uma instância usando C++.