Método INapSystemHealthAgentBinding::Initialize
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 |
|---|---|
|
Êxito na operação. |
|
Erro de permissões, acesso negado. |
|
O limite de recursos do sistema não pôde executar a operação. |
|
Se o SHA tiver sido inicializado anteriormente, esse erro será retornado. |
|
Se o SHA não tiver sido registrado anteriormente, esse erro será retornado. |
|
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 |
|
| IDL |
|
| DLL |
|