Método IWbemQualifierSet::P ut (wbemcli.h)

El método IWbemQualifierSet::P ut escribe el calificador y el valor con nombre. El nuevo calificador sobrescribirá el valor anterior del calificador con el mismo nombre. Si este calificador no existía, se creará.

A veces no es posible escribir el valor de un calificador, por ejemplo, si el calificador se propaga desde otro objeto. Normalmente, los calificadores propagados son de solo lectura, pero se pueden invalidar. Para más información, consulte Tipos de calificador.

Al usar el calificador de clave , no es necesario especificar ningún tipo de tipos ni reglas de propagación.

Es posible que el usuario no cree calificadores con nombres que comiencen o terminen con un carácter de subrayado (_). Esto se reserva para las clases y las propiedades del sistema.

Sintaxis

HRESULT Put(
  [in] LPCWSTR wszName,
  [in] VARIANT *pVal,
  [in] long    lFlavor
);

Parámetros

[in] wszName

Nombre del calificador que se está escribiendo. El puntero se trata como de solo lectura.

[in] pVal

No puede ser NULL. Debe apuntar a un VALOR VARIANT válido que contenga el valor de calificador que se va a escribir. El puntero se trata como de solo lectura. Es responsabilidad del autor de la llamada llamar a VariantClear en este puntero después de que el valor no sea necesario.

Solo se admiten variantes y matrices de tipos VT_I4, VT_R8, VT_BSTR, VT_BOOL .

[in] lFlavor

Sabores de calificador deseados para este calificador. En la lista siguiente se enumeran las constantes adecuadas para lFlavor. El valor predeterminado es cero (0).

WBEM_FLAVOR_OVERRIDABLE (0 (0x0))

El valor del calificador se puede invalidar en una clase derivada o en una instancia. Este es el valor predeterminado. El uso de esta constante es el mismo que el uso de la marca EnableOverride .

WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE (1 (0x1))

El calificador se propaga a las instancias. El uso de esta constante es el mismo que el uso de la marca ToInstance .

WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS (2 (0x2))

Este valor se usa para permitir que el calificador se propague a las clases derivadas. El uso de esta constante es el mismo que el uso de la marca ToSubClass .

WBEM_FLAVOR_NOT_OVERRIDABLE (16 (0x10))

El valor del calificador no se puede invalidar en una clase derivada ni en una instancia de . El uso de esta constante es el mismo que el uso de la marca DisableOverride .

WBEM_FLAVOR_AMENDED (128 (0x80))

Este valor se usa para permitir que el calificador se localice. El uso de esta constante es el mismo que el uso de la marca Modificada .

Valor devuelto

Este método devuelve un valor HRESULT que indica el estado de la llamada al método. En la lista siguiente se muestra el valor contenido en un HRESULT.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	wbemcli.h (include Wbemidl.h)
Library	Wbemuuid.lib
Archivo DLL	Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll

Consulte también

Tipos de calificador