Creación de una instancia mediante MOF

Puedes declarar una instancia básica de una clase en el servicio administración de Windows mediante Managed Object Format (MOF). También puede invalidar los valores predeterminados de una instancia. Para obtener más información, consulte Establecer un valor de propiedad de instancia.

En el procedimiento siguiente se describe cómo declarar una instancia básica de una clase mediante código MOF.

Para declarar una instancia básica de una clase mediante código MOF

1. Use las palabras clave Instance of seguidas del nombre de clase, las llaves y un punto y coma.

   El ejemplo de código siguiente muestra cómo crear una nueva instancia de la clase.

   instance of ClassName
   {
   };
   

2. Cuando termine, inserte el código MOF en el repositorio WMI mediante el compilador MOF.

   Para obtener más información, consulte Compilar archivos MOF.

Una instancia de una clase incluye todas las propiedades de la clase. Si la clase es una clase derivada, las instancias incluyen las propiedades que pertenecen a todas las clases superiores en la jerarquía. Cada clase a partir de la que se crea una instancia tiene una o varias propiedades clave. No se puede crear una instancia con más de 256 claves.

Establecer un valor de propiedad de instancia

Dado que las propiedades de WMI están fuertemente tipadas, no se pueden modificar los tipos de propiedad. Sin embargo, se pueden establecer valores de propiedad en instancias. Cuando una clase asigna un valor predeterminado a una propiedad, WMI asigna el valor predeterminado a cada instancia. Puede invalidar este valor en la declaración de instancia.

En el procedimiento siguiente se describe cómo establecer un valor de propiedad o sobrescribir un valor predeterminado mediante código MOF.

Para establecer un valor de propiedad o sobrescribir un valor predeterminado mediante código MOF

1. Coloque una instrucción de asignación entre las llaves de la declaración de instancia.

   En el siguiente ejemplo de código se muestra cómo establecer el valor de una propiedad.

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

   WMI no requiere que establezca ninguna propiedad durante la creación de la instancia. La excepción es cualquier propiedad marcada con el calificador Key. Dado que WMI usa propiedades de clave para identificar instancias de forma única, debe establecer todas las propiedades de clave a medida que las encuentre. Por el contrario, no debe establecer una propiedad del sistema en una declaración de instancia. Alternativamente, WMI asigna los valores adecuados a una propiedad del sistema cuando es necesario.

2. Cuando termine, inserte el código MOF en el repositorio WMI con una llamada al compilador MOF.

   Para obtener más información, consulte Compilar archivos MOF.

En los ejemplos de código siguientes se muestra cómo una instancia especifica los datos de las propiedades definidas por una clase.

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

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

En el ejemplo anterior, la clase define tres propiedades: una cadena de caracteres, un entero de 32 bits con signo y un entero de 32 bits sin signo. La instancia proporciona valores de datos para cada una de estas propiedades.