Méthode INapSystemHealthValidationRequest::GetSoHRequest

Notes

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

La méthode INapSystemHealthValidationRequest::GetSoHRequest permet aux validateurs d’intégrité système (SHV) de récupérer et de valider les informations SoHRequest envoyées par leurs équivalents SHA (System Health Agent) sur le client.

Syntaxe

HRESULT GetSoHRequest(
  [out] SoHRequest **sohRequest,
  [out] BOOL       *napSystemGenerated
);

Paramètres

sohRequest [out]

Pointeur vers un pointeur vers une structure SoHRequest .

napSystemGenerated [out]

BoOL qui a la valeur TRUE si le SoH a été créé par napAgent pour le compte du SHA et FALSE dans le cas contraire. Il est principalement utilisé pour indiquer une défaillance SHA au SHV.

Valeur retournée

D’autres codes d’erreur spécifiques à COM peuvent également être retournés.

Code de retour	Description
S_OK	Opération réussie.
E_ACCESSDENIED	Erreur d’autorisations, accès refusé.
E_OUTOFMEMORY	Limite de ressources système, impossible d’effectuer l’opération.

Notes

Le paramètre sohRequest peut retourner null si le client n’a pas envoyé de SoHRequest au SHV. Dans ce scénario, le SHV peut remplir un SoHResponse avec le code d’erreur de NAP_E_MISSING_SOH.

Si le paramètre napSystemGenerated a la valeur TRUE, le format de SoHRequest est le suivant :

• id sohAttributeTypeSystemHealthId= <>
• sohAttributeTypeFailureCategory= failureCategoryClientComponent
• sohAttributeTypeErrorCodes = <sha-failure-error-code>

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	NapSystemHealthValidator.h
IDL	NapSystemHealthValidator.idl
DLL	Qshvhost.dll

Voir aussi

INapSystemHealthValidationRequest