INapSystemHealthAgentCallback :: GetSoHRequest, méthode

Notes

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

La méthode INapSystemHealthAgentCallback :: GetSoHRequest est appelée par le NapAgent pour interroger la requête soh de l’agent d’intégrité système.

Syntaxe

HRESULT GetSoHRequest(
  [in] INapSystemHealthAgentRequest *request
);

Paramètres

demande [ dans]

Pointeur COM vers un objet INapSystemHealthAgentRequest qui identifie l’objet de requête.

Valeur de retour

Code de retour Description
_OK
Indique la réussite de l’opération.
HRESULT _ à partir de _ Win32 (RPC _ S _ Server _ non disponible)
Si ce code est retourné par votre implémentation, NapAgent supprime l’algorithme SHA de la liste des transactions de hachage et vide son entrée de cache.

Quand une valeur de retour (à l’exception _ de HRESULT de _ Win32 (RPC _ S _ Server _ non disponible)) est retournée par votre implémentation, le système NAP construit et retourne un SoHRequest à la SHV correspondante avec les types et valeurs d’attribut suivants :

Notes

Cette méthode de rappel est déclarée par le système NAP et doit être implémentée par l’enregistreur SHA.

Cette méthode doit traiter la demande et retourner immédiatement. Le retardement du retour de cette méthode a un impact négatif sur les performances du système et la réactivité, et peut entraîner l’expiration du délai d’autres parties du système d’exploitation.

L’analyse de l’état d’intégrité ne doit pas être effectuée dans le cadre de cet appel, en particulier s’il s’agit d’un calcul intensif et prend beaucoup de temps. L’analyse de l’état d’intégrité et le calcul de l’SoH doivent être effectués dans un service ou un thread distinct. La seule fonction de cette méthode consiste à définir la SoH de l’algorithme SHA et à retourner.

Si l’algorithme SHA prend beaucoup de temps pour générer une SoH, la SoH mise en cache doit être retournée au NapAgent. S’il n’y a aucune déclaration SoH mise en cache à retourner, le SHA doit immédiatement retourner une SoH avec les valeurs et types d’attributs suivants :

Une fois la SoH générée, l’agent SHA doit appeler INapSystemHealthAgentBinding :: NotifySoHChange pour notifier le NapAgent de la modification d’intégrité du système.

Le NapAgent appelle cette méthode pour interroger le SoHRequest de l’agent d’intégrité système. L’agent SHA peut interroger l’objet INapSystemHealthAgentRequest passé pour les paramètres dont il a besoin pour calculer le SoHRequest. L’algorithme SHA doit définir le SoHRequest calculé sur l’objet de requête. L’algorithme SHA ne doit pas contenir de références à l’objet de requête une fois cet appel terminé.

Lorsque cette méthode est appelée, s’il existe une SoH dans le cache de NapAgent, elle est définie sur l’objet de requête. L’agent SHA peut l’interroger à l’aide de GetSoHRequest. Si l’algorithme SHA ne définit pas une nouvelle SoH, l’algorithme mis en cache est utilisé.

Pour les Sha non liés qui sont inscrits auprès du système, le système NAP construit et envoie un SoHRequest au VALIDateur correspondant avec les types et valeurs d’attribut suivants :

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows [Applications de bureau Vista uniquement]
Serveur minimal pris en charge
Windows Serveur 2008 [ applications de bureau uniquement]
En-tête
NapSystemHealthAgent. h
MIDL
NapSystemHealthAgent. idl

Voir aussi

INapSystemHealthAgentCallback