Key (calificador)

El calificador Key indica si la propiedad forma parte del identificador del espacio de nombres. Si más de una propiedad tiene el calificador Key, todas forman colectivamente la clave (una clave compuesta). Cuando se combinan, las propiedades de clave deben proporcionar una referencia única para cada instancia de clase. Si este calificador se coloca en una propiedad, solo se permite el valor TRUE.

Puede usar cualquier tipo de propiedad, excepto para lo siguiente:

  • Matrices
  • Números de punto flotante y real
  • Objetos insertados
  • Caracteres inferiores a ASCII 32 (es decir, caracteres de espacio en blanco)
  • Las cadenas de caracteres de tipo char16 o cadenas de caracteres definidas como claves deben contener valores mayores que U+0020. Esto se debe a que WMI usa valores de clave en rutas de acceso de objeto y no se pueden usar caracteres no imprimibles en una ruta de acceso de objeto.

Cuando una clase primaria especifica una clave, todas las clases derivadas de la primaria heredan esa clave. Las clases derivadas no pueden modificar la clave heredada ni definir ninguna propiedad de clave nueva. Pero cuando una subclase se deriva de una clase abstracta sin una clave, puede introducir una clave en la subclase.

Todas las clases que definen más de una instancia deben especificar una clave. Como las clases abstractas no definen ninguna instancia, no necesitan especificar claves. Como las clases singleton definen solo una instancia, no pueden especificar claves.

Las claves se escriben una vez durante la creación de instancias de objeto y no se deben modificar más adelante. No tiene sentido aplicar un valor predeterminado a una propiedad calificada con clave.

Requisitos

Requisito Value
Cliente mínimo compatible
Windows Vista
Servidor mínimo compatible
Windows Server 2008