Partilhar via


Criando uma instância usando MOF

Você pode declarar uma instância básica de uma classe no serviço de Gerenciamento do Windows usando o MOF (Managed Object Format). Você também pode alterar os valores padrão de uma instância. Para obter mais informações, consulte Definindo um valor de propriedade de instância.

O procedimento a seguir descreve como declarar uma instância básica de uma classe usando o código MOF.

Para declarar uma instância básica de uma classe usando o código MOF

  1. Use a Instância de palavras-chave seguidas pelo nome da classe, chaves e ponto-e-vírgula.

    O exemplo de código a seguir mostra como declarar uma instância de uma classe.

    instance of ClassName
    {
    };
    
  2. Quando terminar, insira o código MOF no repositório WMI usando o compilador MOF.

    Para obter mais informações, consulte compilando arquivos MOF.

Uma instância de uma classe inclui todas as propriedades da classe. Se a classe for uma classe derivada, as instâncias incluirão as propriedades pertencentes a todas as classes mais altas na hierarquia. Cada classe a partir da qual uma instância é criada tem uma ou mais propriedades de chave. Não é possível criar uma instância com mais de 256 chaves.

Definindo um valor de propriedade de instância

Como o WMI atribui tipos às propriedades de forma rígida, não é possível modificar os tipos de propriedades. No entanto, você pode definir valores de propriedade em instâncias. Quando uma classe atribui um valor padrão a uma propriedade, o WMI atribui o valor padrão a cada instância. Você pode substituir esse valor em sua declaração de instância.

O procedimento a seguir descreve como definir um valor de propriedade ou substituir um valor padrão usando o código MOF.

Para definir um valor de propriedade ou substituir um valor padrão usando o código MOF

  1. Coloque uma instrução de atribuição entre as chaves da declaração de instância.

    O exemplo de código a seguir mostra como definir um valor de propriedade.

    instance of ClassName
    {
        Prop = "value";
    };
    

    O WMI não requer que você defina nenhuma propriedade durante a criação da instância. A exceção é qualquer propriedade marcada com o qualificador Key. Como o WMI usa propriedades de chave para identificar instâncias exclusivamente, você deve definir todas as propriedades de chave à medida que as encontrar. Por outro lado, você não deve definir uma propriedade do sistema em uma declaração de instância. Em vez disso, o WMI atribui os valores apropriados a uma propriedade do sistema quando necessário.

  2. Quando terminar, insira o código MOF no repositório WMI com uma chamada para o compilador MOF.

    Para obter mais informações, consulte compilando arquivos MOF.

Os exemplos de código a seguir mostram como uma instância especifica dados para propriedades definidas por uma classe.

class MyClass 
{
    [key] string   strProp;
    sint32   dwProp1;
    uint32       dwProp2;
};

instance of MyClass 
{
    strProp = "hello";
    dwProp1 = -1;
    dwProp2 = 0xffffffff;
};

No exemplo anterior, a classe define três propriedades: uma cadeia de caracteres, um inteiro assinado de 32 bits e um inteiro não assinado de 32 bits. A instância fornece valores de dados para cada uma dessas propriedades.