INapSystemHealthAgentCallback::CompareSoHRequests-Methode

Hinweis

Die Netzwerkzugriffsschutz-Plattform ist ab dem Windows 10

Die INapSystemHealthAgentCallback::CompareSoHRequests-Methode wird vom SHA verwendet, um SoH-Anforderungen zu vergleichen.

Syntax

HRESULT CompareSoHRequests(
  [in]  const SoHRequest *lhs,
  [in]  const SoHRequest *rhs,
  [out]       BOOL       *isEqual
);

Parameter

ls [ In]

Ein Zeiger auf soHRequest links vom Vergleichsvorgang.

rhs [ In]

Ein Zeiger auf soHRequest rechts vom Vergleichsvorgang.

isEqual [ out]

Ein Zeiger auf eine BOOL, die TRUE ist, wenn ls und rhs semantisch gleich sind, andernfalls FALSE.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode Beschreibung
S _ OK
Gibt die erfolgreiche Ausführung an.
E _ NOTIMPL
Die -Methode wurde vom SHA nicht implementiert.

Bemerkungen

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

Der SHA sollte die SoHs vergleichen und TRUE zurückgeben, wenn die SoHs semantisch gleich sind. NapAgent verwendet diese Informationen, um zu bestimmen, ob aufgrund einer Statusänderung des Clientcomputers ein SoH-Austausch initiiert werden soll.

Wenn SHAs inkrementelle IDs oder Zeitstempel in ihren SoH-Wert setzen, sind SoHs möglicherweise semantisch gleich (d. h. sie übermitteln möglicherweise die gleichen Integritätsinformationen), sind aber möglicherweise byteweise ungleich. SHAs sollten diese Funktion implementieren, um die semantische Gleichheit von SoHs zu überprüfen.

Wenn SHAs keine Zeitstempel oder IDs in ihre SoHs setzen, können sie diese Funktion nicht implementieren und E _ NOTIMPL zurückgeben. In diesem Fall führt napAgent einen byteweisen Vergleich für soHRequests durch.

Requirements (Anforderungen)

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

Weitere Informationen

INapSystemHealthAgentCallback

Soh