INapSystemHealthAgentBinding::NotifySoHChange-Methode

Hinweis

Die Netzwerkzugriffsschutz-Plattform ist ab dem Windows 10

Die INapSystemHealthAgentBinding::NotifySoHChange-Methode wird von SHAs verwendet, wenn sich deren SoH ändert.

Syntax

HRESULT NotifySoHChange();

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Es können auch andere COM-spezifische Fehlercodes zurückgegeben werden.

Rückgabecode Beschreibung
S _ OK
Vorgang erfolgreich.
E _ ACCESSDENIED
Berechtigungsfehler, Zugriff verweigert.
E _ OUTOFMEMORY
Systemressourcenlimit, konnte den Vorgang nicht ausführen.
NAP _ E _ NICHT _ INITIALISIERT
Die SHA wurde noch nicht initialisiert.
RPC _ E _ DISCONNECTED
Der NapAgent wurde beendet. Dieses Objekt wird automatisch wiederhergestellt und erneut an den NapAgent gebunden, sobald es neu gestartet wird.

Bemerkungen

SHAs dürfen diese API nicht spekulativ aufrufen, da sie zu einem SoH-Austausch im Netzwerk führt. Aufrufe dieser API sollten nur bei Bedarf vorgenommen werden.

Der NapAgent enthält diesen Thread nicht, um die SoH-Änderung zu verarbeiten. Stattdessen wird sofort zurückgegeben und die Änderung asynchron verarbeitet.

Der SHA muss Initialize aufrufen, bevor diese Methode oder eine andere Methode der INapSystemHealthAgentBinding2-Schnittstelle aufruft.

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
DLL
Qagent.dll

Weitere Informationen

INapSystemHealthAgentBinding