INapSystemHealthAgentBinding::Initialize, méthode

Notes

La plateforme de protection d’accès réseau n’est pas disponible à partir de Windows 10

La méthode INapSystemHealthAgentBinding::Initialize initialise l’agent d’intégrité système (SHA) et lie le SHA au service NapAgent. Cette méthode doit être appelée avant d’appeler toute autre méthode sur l’interface INapSystemHealthAgentBinding2 .

Syntaxe

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

Paramètres

id [in]

SystemHealthEntityId unique qui contient l’ID du SHA lié au service NapAgent.

rappel [in]

Pointeur COM vers une interface INapSystemHealthAgentCallback utilisée par NapAgent pour rappeler l’agent d’intégrité avec une notification/un processus. NapAgent conserve une référence à l’objet associé à cette interface jusqu’à ce que Uninitialize soit appelé.

Valeur retournée

D’autres codes d’erreur spécifiques à COM peuvent également être retournés.

Code de retour	Description
S_OK	Opération réussie.
E_ACCESSDENIED	Erreur d’autorisations, accès refusé.
E_OUTOFMEMORY	Limite de ressources système, impossible d’effectuer l’opération.
ERROR_ALREADY_INITIALIZED	Si le SHA s’est initialisé précédemment, cette erreur est retournée.
NAP_E_NOT_REGISTERED	Si le SHA n’a pas été inscrit précédemment, cette erreur est retournée.
RPC_E_DISCONNECTED	NapAgent a été arrêté. Cet objet est récupéré automatiquement et rebiné au NapAgent, une fois qu’il a redémarré.

Notes

NapAgent ne déclenche pas d’échange SoH à la suite de l’initialisation. Un agent d’intégrité système doit appeler NotifySoHChange pour demander un échange de paquets SoH après l’initialisation avec NapAgent.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	NapSystemHealthAgent.h
IDL	NapSystemHealthAgent.idl
DLL	Qagent.dll

Voir aussi

INapSystemHealthAgentBinding