INapSystemHealthAgentCallback :: NotifyOrphanedSoHRequest, 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 :: NotifyOrphanedSoHRequest est appelée si un SoHRequest a été interrogé à partir de l’algorithme SHA, mais que la réponse n’a jamais été renvoyée.

Syntaxe

HRESULT NotifyOrphanedSoHRequest(
  [in] const CorrelationId *correlationId
);

Paramètres

CorrelationId [ dans]

Pointeur vers la structure d’ID de corrélation unique qui identifie le SoHRequestorphelin.

Valeur de retour

Cette méthode peut retourner l’une de ces valeurs.

Code de retour Description
_OK
Indique la réussite de l’opération.

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 peut être appelée par le système dans les cas suivants :

  • Un SoHRequest n’a pas pu être envoyé sur le réseau.
  • Un SoHRequest a été envoyé sur le réseau, mais aucun SoHResponse n’a été renvoyé, c.-à-d. que l’application a dépassé le délai d’attente ou qu’il n’y avait pas de validateur de validateur correspondant côté serveur.
  • La connexion s’est arrêtée ou un enforceur est passé hors connexion.

Comme il ne s’agit que d’une notification de meilleur effort, il ne doit pas compter sur ces informations pour nettoyer l’État. Il existe plusieurs situations dans lesquelles un SHA ne sera pas notifié :

  • En cas de dysfonctionnement d’un application, autrement dit, il n’avertit pas l’SHA lorsque l’état de la connexion est inactif.
  • Si une application se bloque.
  • Dans les conditions d’erreur, par exemple, la mémoire NapAgent est insuffisante.

Les agents d’intégrité du service peuvent obtenir des notifications erronées lorsqu’ils se lient pour la première fois au NapAgent, par exemple, si un échange SoH est en cours d’exécution lorsque la liaison SHA est terminée, puis expire.

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