INapSystemHealthAgentCallback::GetSoHRequest-Methode

Artikel
06/13/2023

Hinweis

Die Netzwerkzugriffsschutzplattform ist ab Windows 10

Die INapSystemHealthAgentCallback::GetSoHRequest-Methode wird vom NapAgent aufgerufen, um die SoH-Anforderung des Systemintegritäts-Agents abzufragen.

Syntax

HRESULT GetSoHRequest(
  [in] INapSystemHealthAgentRequest *request
);

Parameter

Anforderung [in]: Ein COM-Zeiger auf ein INapSystemHealthAgentRequest-Objekt , das das Anforderungsobjekt identifiziert.

Rückgabewert

Rückgabecode	BESCHREIBUNG
S_OK	Gibt die erfolgreiche Ausführung an.
HRESULT_FROM_WIN32(RPC_S_SERVER_UNAVAILABLE)	Wenn dieser Code von Ihrer Implementierung zurückgegeben wird, entfernt napAgent den SHA aus der Liste bound-SHA und löscht den Cacheeintrag.

Wenn ein Rückgabewert (mit Ausnahme von HRESULT_FROM_WIN32(RPC_S_SERVER_UNAVAILABLE)) von Ihrer Implementierung zurückgegeben wird, erstellt das NAP-System eine SoHRequest und gibt eine SoHRequest an den entsprechenden SHV mit den folgenden Attributtypen und Werten zurück:

sohAttributeTypeSystemHealthId= <id>
sohAttributeTypeFailureCategory= failureCategoryClientComponent
sohAttributeTypeErrorCodes = <error-code>

Bemerkungen

Diese Rückrufmethode wird vom NAP-System deklariert und vom SHA-Writer implementiert.

Diese Methode muss die Anforderung verarbeiten und sofort zurückgeben. Die Verzögerung der Rückgabe dieser Methode wirkt sich negativ auf die Systemleistung und Reaktionsfähigkeit aus und kann zu einem Timeout für andere Teile des Betriebssystems führen.

Die Überwachung des Integritätszustands sollte nicht im Rahmen dieses Aufrufs durchgeführt werden, insbesondere dann, wenn sie berechnungsintensiv ist und lange dauert. Integritätszustandsüberwachung und SoH-Berechnung sollten in einem separaten Thread oder Dienst ausgeführt werden. Die einzige Funktion dieser Methode sollte darin sein, die SoH des SHA festzulegen und zurückzugeben.

Wenn es lange dauert, bis der SHA einen SoH generiert, sollte das zwischengespeicherte SoH an den NapAgent zurückgegeben werden. Wenn kein zwischengespeichertes SoH zurückgegeben werden soll, sollte der SHA sofort einen SoH mit den folgenden Attributtypen und -werten zurückgeben:

Wenn der SoH generiert wurde, muss der SHA INapSystemHealthAgentBinding::NotifySoHChange aufrufen, um den NapAgent über die Systemintegritätsänderung zu benachrichtigen.

NapAgent ruft diese Methode auf, um die SoHRequest des Systemintegritäts-Agents abzufragen. Der SHA kann das übergebene INapSystemHealthAgentRequest-Objekt nach Parametern abfragen, die zum Berechnen der SoHRequest erforderlich sind. Der SHA muss die berechnete SoHRequest für das Anforderungsobjekt festlegen. Der SHA darf keine Verweise auf das Anforderungsobjekt enthalten, wenn dieser Aufruf abgeschlossen ist.

Wenn diese Methode aufgerufen wird, wird sie für das Anforderungsobjekt festgelegt, wenn im NapAgent-Cache ein SoH vorhanden ist. Der SHA kann sie mithilfe von GetSoHRequest abfragen. Wenn der SHA keinen neuen SoH-Wert legt, wird das zwischengespeicherte verwendet.

Für ungebundene SHAs, die beim System registriert sind, erstellt und sendet das NAP-System eine SoHRequest mit den folgenden Attributtypen und Werten an den entsprechenden SHV:

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	NapSystemHealthAgent.h
IDL	NapSystemHealthAgent.idl

Siehe auch

INapSystemHealthAgentCallback

Freigeben über