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 |
|---|---|
|
Indique la réussite de l’opération. |
|
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 :
- = sohAttributeTypeSystemHealthId < identifi>
- sohAttributeTypeFailureCategory = failureCategoryClientComponent
- = sohAttributeTypeErrorCodes < erreur : code>
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 :
- = sohAttributeTypeSystemHealthId < identifi>
- sohAttributeTypeFailureCategory = failureCategoryClientCommunication
- sohAttributeTypeErrorCodes = E/r NAP _ _ non _ mis en cache _
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 :
- = sohAttributeTypeSystemHealthId < identifi>
- sohAttributeTypeFailureCategory = failureCategoryClientComponent
- sohAttributeTypeErrorCodes = NAP _ E _ non _ initialisé
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 |
|
| MIDL |
|