Partager via


Méthode INapSystemHealthAgentCallback::NotifyOrphanedSoHRequest

Notes

La plateforme 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 du SHA, mais la réponse n’est jamais revenue.

Syntaxe

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

Paramètres

correlationId [in]

Pointeur vers la structure CorrelationId unique qui identifie le SoHRequest orphelin.

Valeur retournée

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

Code de retour Description
S_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.
  • Une demande SoHRequest a été envoyée sur le réseau, mais aucun SoHResponse n’est revenu, c’est-à-dire que l’application a expiré ou qu’il n’y avait pas de SHV correspondant côté serveur.
  • La connexion a été arrêtée ou l’application a été mise hors connexion.

Il ne s’agit que d’une notification du meilleur effort. Les autorités de shas ne doivent donc pas s’appuyer sur ces informations pour propre’état. Il existe plusieurs situations dans lesquelles un SHA ne sera pas averti :

  • Si un exécuteur se comporte mal, c’est-à-dire qu’il n’avertit pas le SHA lorsque l’état de la connexion est arrêté.
  • Si un application se bloque.
  • Dans des conditions d’erreur, c’est-à-dire que napAgent est en mémoire insuffisante.

Les autorités de sécurité peuvent recevoir des notifications fallacieuses lorsqu’elles se lient pour la première fois au NapAgent, par instance, si un échange SoH est en cours lorsque le SHA est lié, puis expire.

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

Voir aussi

INapSystemHealthAgentCallback