INapSystemHealthValidationRequest::GetSoHRequest-Methode

Hinweis

Die Netzwerkzugriffsschutzplattform ist ab Windows 10

Mit der INapSystemHealthValidationRequest::GetSoHRequest-Methode können System Health Validators (SHVs) die SoHRequest-Informationen abrufen und überprüfen, die von ihren System Health Agent -Gegenstücken (SHA) auf dem Client gesendet wurden.

Syntax

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

Parameter

sohRequest [out]

Ein Zeiger auf einen Zeiger auf eine SoHRequest-Struktur .

napSystemGenerated [out]

Ein BOOL , der TRUE ist, wenn der SoH vom NapAgent im Namen des SHA erstellt wurde, andernfalls FALSE . Es wird in erster Linie verwendet, um einen SHA-Fehler für den SHV anzuzeigen.

Rückgabewert

Es können auch andere COM-spezifische Fehlercodes zurückgegeben werden.

Rückgabecode	Beschreibung
S_OK	Vorgang erfolgreich.
E_ACCESSDENIED	Berechtigungsfehler, Zugriff verweigert.
E_OUTOFMEMORY	Systemressourcenlimit konnte den Vorgang nicht ausführen.

Bemerkungen

Der sohRequest-Parameter gibt möglicherweise NULL zurück, wenn der Client keine SoHRequest an den SHV gesendet hat. In diesem Szenario kann der SHV eine SoHResponse mit dem Fehlercode von NAP_E_MISSING_SOH auffüllen.

Wenn der napSystemGenerated-ParameterTRUE ist, lautet das Format von SoHRequest wie folgt:

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	NapSystemHealthValidator.h
IDL	NapSystemHealthValidator.idl
DLL	Qshvhost.dll

Weitere Informationen

INapSystemHealthValidationRequest