Método INapSystemHealthAgentBinding::Initialize

  • Artigo

Observação

A plataforma de Proteção de Acesso à Rede não está disponível a partir do Windows 10

O método INapSystemHealthAgentBinding::Initialize inicializa o SHA (agente de integridade do sistema) e associa o SHA ao serviço NapAgent. Esse método deve ser chamado antes de chamar qualquer outro método na interface INapSystemHealthAgentBinding2 .

Sintaxe

HRESULT Initialize(
  [in] SystemHealthEntityId          id,
  [in] INapSystemHealthAgentCallback *callback
);

Parâmetros

id [in]

Um SystemHealthEntityId exclusivo que contém a ID do SHA associado ao serviço NapAgent.

retorno de chamada [in]

Um ponteiro COM para uma interface INapSystemHealthAgentCallback usada pelo NapAgent para chamar o agente de integridade com uma notificação/processo. O NapAgent mantém uma referência ao objeto associado a essa interface até que Uninitialize seja chamado.

Valor retornado

Outros códigos de erro específicos do COM também podem ser retornados.

Código de retorno Descrição
S_OK
Êxito na operação.
E_ACCESSDENIED
Erro de permissões, acesso negado.
E_OUTOFMEMORY
O limite de recursos do sistema não pôde executar a operação.
ERROR_ALREADY_INITIALIZED
 Se o SHA tiver sido inicializado anteriormente, esse erro será retornado.
NAP_E_NOT_REGISTERED
 Se o SHA não tiver sido registrado anteriormente, esse erro será retornado.
RPC_E_DISCONNECTED
 O NapAgent foi interrompido. Esse objeto será recuperado automaticamente e reassociado ao NapAgent, assim que ele for reiniciado.

Comentários

O NapAgent não dispara uma troca de SoH como resultado da inicialização. Um agente de integridade do sistema deve chamar NotifySoHChange para solicitar uma troca de pacotes SoH após a inicialização com o NapAgent.

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]
Cabeçalho
NapSystemHealthAgent.h
IDL
NapSystemHealthAgent.idl
DLL
Qagent.dll

Confira também

INapSystemHealthAgentBinding