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 |
|---|---|
|
Vorgang erfolgreich. |
|
Berechtigungsfehler, Zugriff verweigert. |
|
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 |
|
| IDL |
|
| DLL |
|