función QualifierSet_Put

Escribe el calificador y el valor con nombre. El nuevo calificador sobrescribe el valor anterior del mismo nombre. Si el calificador no existe, se crea.

Nota:

Esta API es solo para uso interno. No está pensado para su uso desde el código de desarrollador.

Syntax

HRESULT QualifierSet_Put (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LPCWSTR              wszName,
   [in] VARIANT*             pVal,
   [in] LONG                 lFlavor
);

Parámetros

vFunc
[in] Este parámetro no se usa.

ptr
[in] Puntero a una instancia de IWbemQualifierSet .

wszName
[in] Nombre del calificador que se va a escribir.

pVal
[in] Puntero a un valor válido VARIANT que contiene el calificador que se va a escribir. Este parámetro no puede ser null.

lFlavor
[in] Una de las siguientes constantes que define los tipos de calificador deseados para este calificador. El valor predeterminado es WBEM_FLAVOR_OVERRIDABLE (0).

Constante	Importancia	Description
WBEM_FLAVOR_OVERRIDABLE	0	El calificador se puede invalidar en una clase o instancia derivadas. Este es el valor predeterminado.
WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE	1	El calificador se propaga a instancias.
WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS	2	El calificador se propaga a las clases derivadas.
WBEM_FLAVOR_NOT_OVERRIDABLE	0x10	El calificador no se puede invalidar en una clase o instancia derivadas.
WBEM_FLAVOR_AMENDED	0x80	El calificador se localiza.

Valor devuelto

Los siguientes valores devueltos por esta función se definen en el archivo de encabezado WbemCli.h , o bien puede definirlos como constantes en el código:

Constante	Importancia	Description
WBEM_E_CANNOT_BE_KEY	0x8004101f	Hubo un intento no válido de especificar el Key calificador en una propiedad que no puede ser una clave. Las claves se especifican en la definición de clase de un objeto y no se pueden modificar por instancia.
WBEM_E_INVALID_PARAMETER	0x80041008	Un parámetro no es válido.
WBEM_E_INVALID_QUALIFIER_TYPE	0x80041029	El pVal parámetro no es de un tipo de calificador legal.
WBEM_E_OVERRIDE_NOT_ALLOWED	0x8004101a	No es posible llamar al QualifierSet_Put método en el calificador porque el objeto propietario no permite invalidaciones.
WBEM_S_NO_ERROR	0	La llamada de función se realizó correctamente.

Observaciones

Esta función ajusta una llamada al método IWbemQualifierSet::P ut .

Requisitos

Plataformas: Consulte Requisitos del sistema.

Encabezado: WMINet_Utils.idl

Versiones de .NET Framework: Disponible desde la versión 4.7.2

Consulte también

• Contadores de rendimiento y WMI (referencia de API no administrada)