Compartilhar via


Função WDEnable (windowsdefender.h)

Altera Windows Defender status para ativar ou desativar.

Observação  

O WDEnable não está mais disponível para uso a partir de Windows 10 versão 1607.

A partir de Windows 10, versão 1607 e Windows Server 2016, a função WDEnable sempre retorna E_NOTIMPL.

 

Sintaxe

HRESULT WDEnable(
  [in] BOOL fEnable
);

Parâmetros

[in] fEnable

Tipo: BOOL

Windows Defender status que o aplicativo de chamada deseja definir. TRUE habilita Windows Defender. FALSE desabilita Windows Defender.

Retornar valor

Tipo: HRESULT

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
Windows Defender está configurado para o estado solicitado.
E_ACCESSDENIED
O aplicativo de chamada não tem permissão suficiente ou é sinalizado como uma ameaça Windows Defender banco de dados de assinatura.

Chamar a identidade do aplicativo não é verificável por meio da assinatura digital.

HRESULT_FROM_WIN32(ERROR_ACCESS_DISABLED_BY_POLICY)
A solicitação de aplicativo de chamada contradiz o Windows Defender status definido pela política de grupo.
E_NOTIMPL
Não implementado.

Comentários

O aplicativo que chama essa função deve ser executado com permissões de administrador no computador local. Windows Defender também valida (1) a assinatura adequada do processo de chamada e todos os módulos carregados e (2) que o sinalizador IMAGE_DLLCHARACTERISTICS_FORCE_INTEGRITY está definido no processo de chamada e em todos os módulos carregados antes de permitir que o aplicativo de chamada altere o status. Se a imagem do processo de chamada (ou qualquer módulo carregado) não estiver assinada ou for sinalizada como uma ameaça pela assinatura Windows Defender, a chamada falhará com o código de erro apropriado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho windowsdefender.h
DLL MpClient.dll

Confira também

WDStatus