INapSystemHealthAgentCallback::CompareSoHRequests-Methode
Hinweis
Die Netzwerkzugriffsschutzplattform ist ab Windows 10
Die INapSystemHealthAgentCallback::CompareSoHRequests-Methode wird vom SHA zum Vergleichen von SoH-Anforderungen verwendet.
Syntax
HRESULT CompareSoHRequests(
[in] const SoHRequest *lhs,
[in] const SoHRequest *rhs,
[out] BOOL *isEqual
);
Parameter
-
lhs [in]
-
Ein Zeiger auf die SoHRequest auf der linken Seite des Vergleichsvorgangs.
-
rhs [in]
-
Ein Zeiger auf die SoHRequest auf der rechten Seite des Vergleichsvorgangs.
-
isEqual [out]
-
Ein Zeiger auf eine BOOL , der TRUE ist, wenn lhs und rhs semantisch gleich sind, andernfalls FALSE .
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Gibt die erfolgreiche Ausführung an. |
|
Die -Methode wurde nicht vom SHA implementiert. |
Bemerkungen
Diese Rückrufmethode wird vom NAP-System deklariert und vom SHA-Writer implementiert.
Der SHA sollte die SoHs vergleichen und TRUE zurückgeben, wenn die SoHs semantisch gleich sind. Der NapAgent verwendet diese Informationen, um zu bestimmen, ob aufgrund einer Änderung des Zustands des Clientcomputers ein SoH-Austausch initiiert werden soll.
Wenn SHAs inkrementelle IDs oder Zeitstempel in ihre SoH eingefügt haben, können SoHs semantisch gleich sein (d. h. sie können die gleichen Gesundheitsinformationen vermitteln), aber sie können byteweise ungleich sein. SHAs sollten diese Funktion implementieren, um die semantische Gleichheit von SoHs zu überprüfen.
Wenn SHAs keine Zeitstempel oder IDs in ihre SoHs eingefügt haben, können sie diese Funktion nicht implementieren und E_NOTIMPL zurückgeben. In diesem Fall führt der NapAgent einen byteweisen Vergleich für die SoHRequests durch.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 [nur Desktop-Apps] |
| Header |
|
| IDL |
|