Condividi tramite


Metodo INapSystemHealthAgentBinding::Initialize

Nota

La piattaforma Network Access Protection non è disponibile a partire da Windows 10

Il metodo INapSystemHealthAgentBinding::Initialize inizializza l'agente di integrità del sistema e associa lo SHA al servizio NapAgent. Questo metodo deve essere chiamato prima di chiamare qualsiasi altro metodo nell'interfaccia INapSystemHealthAgentBinding2 .

Sintassi

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

Parametri

id [in]

Oggetto SystemHealthEntityId univoco che contiene l'ID dello SHA associato al servizio NapAgent.

callback [in]

Puntatore COM a un'interfaccia INapSystemHealthAgentCallback usata da NapAgent per eseguire il callback dell'agente di integrità con una notifica/processo. NapAgent contiene un riferimento all'oggetto associato a questa interfaccia finché non viene chiamato Uninitialize .

Valore restituito

Altri codici di errore specifici di COM possono essere restituiti anche.

Codice restituito Descrizione
S_OK
Operazione riuscita.
E_ACCESSDENIED
Errore delle autorizzazioni, accesso negato.
E_OUTOFMEMORY
Limite di risorse di sistema, non è stato possibile eseguire l'operazione.
ERROR_ALREADY_INITIALIZED
Se lo SHA è stato inizializzato in precedenza, questo errore viene restituito.
NAP_E_NOT_REGISTERED
Se lo SHA non è stato registrato in precedenza, viene restituito questo errore.
RPC_E_DISCONNECTED
NapAgent è stato arrestato. Questo oggetto verrà ripristinato automaticamente e ribinato in NapAgent, una volta riavviato.

Commenti

NapAgent non attiva uno scambio SoH in seguito all'inizializzazione. Un agente di integrità del sistema deve chiamare NotifySoHChange per richiedere uno scambio di pacchetti SoH dopo l'inizializzazione con NapAgent.

Requisiti

Requisito Valore
Client minimo supportato
Windows Vista [solo app desktop]
Server minimo supportato
Windows Server 2008 [solo app desktop]
Intestazione
NapSystemHealthAgent.h
IDL
NapSystemHealthAgent.idl
DLL
Qagent.dll

Vedi anche

INapSystemHealthAgentBinding