Freigeben über


INapSystemHealthAgentCallback::NotifyOrphanedSoHRequest-Methode

Hinweis

Die Netzwerkzugriffsschutzplattform ist ab Windows 10

Die INapSystemHealthAgentCallback::NotifyOrphanedSoHRequest-Methode wird aufgerufen, wenn eine SoHRequest vom SHA abgefragt wurde, die Antwort jedoch nie zurückgerufen wurde.

Syntax

HRESULT NotifyOrphanedSoHRequest(
  [in] const CorrelationId *correlationId
);

Parameter

correlationId [in]

Ein Zeiger auf die eindeutige CorrelationId-Struktur , die das verwaiste SoHRequest identifiziert.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Gibt die erfolgreiche Ausführung an.

Bemerkungen

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

Diese Methode kann vom System in den folgenden Fällen aufgerufen werden:

  • Eine SoHRequest konnte nicht über das Kabel gesendet werden.
  • Ein SoHRequest wurde über das Kabel gesendet, aber kein SoHResponse kam zurück, d. h. der Erzwingerer timete oder es gab keinen entsprechenden SHV auf der Serverseite.
  • Die Verbindung ist ausgefallen, oder ein Erzwingerer ging offline.

Dies ist nur eine Best-Effort-Benachrichtigung, daher dürfen sich SHAs nicht auf diese Informationen verlassen, um sauber Status zu erhalten. Es gibt mehrere Situationen, in denen ein SHA nicht benachrichtigt wird:

  • Wenn sich ein Erzwingerer falsch verhalten, d. h. er benachrichtigt den SHA nicht, wenn der Verbindungszustand ausfällt.
  • Wenn ein Erzwingerer abstürzt.
  • Unter Fehlerbedingungen, d. h. der NapAgent ist nicht genügend Arbeitsspeicher vorhanden.

SHAs erhalten möglicherweise einige falsche Benachrichtigungen, wenn sie zum ersten Mal an den NapAgent binden, für instance, wenn ein SoH-Austausch ausgeführt wird, wenn die SHA gebunden ist, und dann ein Zeitüberschreitung.

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

Weitere Informationen

INapSystemHealthAgentCallback