Compartir a través de

Función QualifierSet_Put

  • Artículo

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á.

Nota

Esta API es solo para uso interno. No está pensada para usarla desde código del desarrollador.

Sintaxis

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] El valor de este parámetro se corresponde con un puntero que apunta a una instancia de la interfaz IWbemQualifierSet.

wszName
[in] El valor de este parámetro se corresponde con el nombre del calificador que se va a escribir.

pVal
[in] El valor de este parámetro se corresponde con un puntero que apunta a un valor VARIANT válido donde se almacena el calificador que se va a escribir. Este parámetro no puede ser null.

lFlavor
[in] El valor de este parámetro se corresponde con una de las siguientes constantes que se usan para definir los tipos de calificador que se desea usar en este calificador. El valor predeterminado es WBEM_FLAVOR_OVERRIDABLE (0).

Constante Valor Descripción
WBEM_FLAVOR_OVERRIDABLE 0 Este valor se usa para permitir que el calificador pueda invalidarse en una clase o instancia derivada. Este es el valor predeterminado.
WBEM_FLAVOR_FLAG_PROPAGATE_TO_INSTANCE 1 El calificador se propaga a las instancias.
WBEM_FLAVOR_FLAG_PROPAGATE_TO_DERIVED_CLASS 2 Este valor se usa para permitir que el calificador se propague a las clases derivadas.
WBEM_FLAVOR_NOT_OVERRIDABLE 0x10 El calificador no puede invalidarse en una clase o instancia derivada.
WBEM_FLAVOR_AMENDED 0x80 Este valor se usa para permitir que el calificador se localice.

Valor devuelto

Los siguientes valores que devuelve esta función se definen en el archivo de encabezado WbemCli.h, aunque también puede definirlos como constantes en el código. Puede consultarlos a continuación:

Constante Valor Descripción
WBEM_E_CANNOT_BE_KEY 0x8004101f Si se devuelve este valor, significa que se produjo un intento no válido de especificar el calificador de Clave en una propiedad cuyo valor no puede establecerse en una clave. Las claves se especifican en la definición de la clase de un objeto, y no se pueden modificar instancia por instancia.
WBEM_E_INVALID_PARAMETER 0x80041008 Un parámetro no es válido.
WBEM_E_INVALID_QUALIFIER_TYPE 0x80041029 Si se devuelve este valor, significa que valor del parámetro pVal no es un tipo de calificador legal.
WBEM_E_OVERRIDE_NOT_ALLOWED 0x8004101a Si se devuelve este valor, significa que no es posible llamar al método QualifierSet_Put en relación con el calificador porque no se admiten invalidaciones en el objeto propietario.
WBEM_S_NO_ERROR 0 Si se devuelve este valor, significará que la llamada a la función se realizó correctamente.

Comentarios

Al usar esta función, se ajusta una llamada al método IWbemQualifierSet::Put.

Requisitos

Plataformas: Vea Requisitos de sistema.

Encabezado: WMINet_Utils.idl

Versiones de .NET Framework: está disponible desde la versión 4.7.2

Consulte también