Freigeben über


INapSystemHealthAgentBinding::NotifySoHChange-Methode

Hinweis

Die Netzwerkzugriffsschutzplattform ist ab 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_NOT_INITIALIZED
Der SHA wurde zuvor nicht initialisiert.
RPC_E_DISCONNECTED
Der NapAgent wurde beendet. Dieses Objekt wird automatisch wiederhergestellt und nach dem Neustart an napAgent neu gruppiert.

Bemerkungen

SHAs dürfen diese API nicht spekulativ aufrufen, da dies zu einem SoH-Austausch über die Leitung führt. Aufrufe dieser API sollten nur bei Bedarf erfolgen.

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 aufgerufen wird.

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

Siehe auch

INapSystemHealthAgentBinding