INapSystemHealthAgentCallback::GetSoHRequest, méthode

Notes

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

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

Syntaxe

HRESULT GetSoHRequest(
  [in] INapSystemHealthAgentRequest *request
);

Paramètres

request [in]

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

Valeur retournée

Code de retour	Description
S_OK	Indique la réussite de l’opération.
HRESULT_FROM_WIN32(RPC_S_SERVER_UNAVAILABLE)	Si ce code est retourné par votre implémentation, napAgent supprime alors le SHA de la liste sha liée et vide son entrée de cache.

Quand une valeur de retour (à l’exception de HRESULT_FROM_WIN32(RPC_S_SERVER_UNAVAILABLE)) est retournée par votre implémentation, le système NAP construit et retourne une soHRequest au SHV correspondant avec les types d’attributs et les valeurs suivants :

• sohAttributeTypeSystemHealthId= <id>
• sohAttributeTypeFailureCategory= failureCategoryClientComponent
• sohAttributeTypeErrorCodes = <error-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 fait de retarder le retour de cette méthode a un impact négatif sur les performances et la réactivité du système, et peut entraîner l’expiration du délai d’attente d’autres parties du système d’exploitation.

La surveillance de l’état d’intégrité ne doit pas être effectuée dans le cadre de cet appel, en particulier si elle est gourmande en calculs et prend beaucoup de temps. La surveillance de l’état d’intégrité et le calcul soH doivent être effectués dans un thread ou un service distinct. La seule fonction de cette méthode doit être de définir le SoH du SHA et de retourner.

Si la génération d’un SoH par le SHA prend beaucoup de temps, le SoH mis en cache doit être retourné au NapAgent. S’il n’y a pas de SoH mis en cache à retourner, le SHA doit immédiatement retourner un SoH avec les types et valeurs d’attribut suivants :

• sohAttributeTypeSystemHealthId= <id>
• sohAttributeTypeFailureCategory= failureCategoryClientCommunication
• sohAttributeTypeErrorCodes = NAP_E_NO_CACHED_SOH

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

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

Lorsque cette méthode est appelée, s’il existe un SoH dans le cache du NapAgent, il est défini sur l’objet de requête. Le SHA peut l’interroger à l’aide de GetSoHRequest. Si le SHA ne définit pas de nouveau SoH, celui mis en cache est utilisé.

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

• sohAttributeTypeSystemHealthId= <id>
• sohAttributeTypeFailureCategory= failureCategoryClientComponent
• sohAttributeTypeErrorCodes = NAP_E_NOT_INITIALIZED

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