Compartir a través de

Función QualifierSet_Delete

  • Artículo

Elimina un calificador específico por el nombre.

Nota

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

Sintaxis

HRESULT QualifierSet_Delete (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LPCWSTR              wszName
);

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

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 Value Descripción
WBEM_E_INVALID_PARAMETER 0x80041008 El parámetro wszName no es válido.
WBEM_E_INVALID_OPERATION 0x80041016 Si se devuelve este valor, significará que la eliminación de este calificador no es válida.
WBEM_E_NOT_FOUND 0x80041002 Si se devuelve este valor, significará que no se encontró el calificador que se especificó.
WBEM_S_NO_ERROR 0 Si se devuelve este valor, significará que la llamada a la función se realizó correctamente.
WBEM_S_RESET_TO_DEFAULT 0x40002 Si se devuelve este valor, significará que la invalidación local se eliminó y el calificador original del objeto primario ha reanudado el ámbito.

Comentarios

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

Debido a las reglas de propagación de los calificadores, puede darse el caso de que un calificador determinado se haya heredado de otro objeto y que, simplemente, se haya invalidado en la clase o instancia actual. En este caso, podrá usar el método QualifierSet_Delete para restablecer el calificador a su valor heredado original. En este tipo de casos, el uso de esta función le devolverá el código de estado WBEM_S_RESET_TO_DEFAULT.

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