Compartilhar via


Função QualifierSet_Delete

Exclui um qualificador especificado por nome.

Observação

Esta API é somente para uso interno. Ela não é destinada ao uso do código do desenvolvedor.

Sintaxe

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

Parâmetros

vFunc
[in] Esse parâmetro não está em uso.

ptr[in] Um ponteiro para uma instância IWbemQualifierSet.

wszName [in] O nome do qualificador a ser excluído.

Valor retornado

Os seguintes valores retornados por essa função são definidos no arquivo de cabeçalho WbemCli.h, ou você pode defini-los como constantes em seu código:

Constante Valor Descrição
WBEM_E_INVALID_PARAMETER 0x80041008 O parâmetro wszName não é válido.
WBEM_E_INVALID_OPERATION 0x80041016 Excluir este qualificador é ilegal.
WBEM_E_NOT_FOUND 0x80041002 O qualificador especificado não foi encontrado.
WBEM_S_NO_ERROR 0 A chamada de função foi bem-sucedida.
WBEM_S_RESET_TO_DEFAULT 0x40002 A substituição local foi excluída e o qualificador original do objeto pai retomou o escopo.

Comentários

Essa função encapsula uma chamada para o método IWbemQualifierSet::Delete.

Devido às regras de propagação do qualificador, um qualificador específico pode ter sido herdado de outro objeto e meramente substituído na classe ou instância atual. Nesse caso, o QualifierSet_Delete método redefine o qualificador para seu valor original herdado. A função nesse caso retorna o código WBEM_S_RESET_TO_DEFAULTde status.

Requisitos

Plataformas: confira Requisitos do sistema.

Header: WMINet_Utils.idl

Versões do .NET Framework: Disponível desde 4.7.2

Confira também