INapSystemHealthAgentBinding::Initialize-Methode
Hinweis
Die Netzwerkzugriffsschutzplattform ist ab Windows 10
Die INapSystemHealthAgentBinding::Initialize-Methode initialisiert den Systemintegritäts-Agent (SHA) und bindet den SHA an den NapAgent-Dienst. Diese Methode muss aufgerufen werden, bevor eine andere Methode auf der INapSystemHealthAgentBinding2-Schnittstelle aufgerufen wird.
Syntax
HRESULT Initialize(
[in] SystemHealthEntityId id,
[in] INapSystemHealthAgentCallback *callback
);
Parameter
-
id [in]
-
Eine eindeutige SystemHealthEntityId , die die ID der SHA enthält, die an den NapAgent-Dienst gebunden ist.
-
Rückruf [in]
-
Ein COM-Zeiger auf eine INapSystemHealthAgentCallback-Schnittstelle , die vom NapAgent verwendet wird, um den Integritäts-Agent mit einer Benachrichtigung/einem Prozess zurückzurufen. Der NapAgent enthält einen Verweis auf das Objekt, das dieser Schnittstelle zugeordnet ist, bis Uninitialize aufgerufen wird.
Rückgabewert
Andere COM-spezifische Fehlercodes können ebenfalls zurückgegeben werden.
| Rückgabecode | Beschreibung |
|---|---|
|
Vorgang erfolgreich. |
|
Berechtigungsfehler, Zugriff verweigert. |
|
Das Systemressourcenlimit konnte den Vorgang nicht ausführen. |
|
Wenn der SHA zuvor initialisiert wurde, wird dieser Fehler zurückgegeben. |
|
Wenn der SHA noch nicht registriert wurde, wird dieser Fehler zurückgegeben. |
|
Der NapAgent wurde beendet. Dieses Objekt wird automatisch wiederhergestellt und nach dem Neustart wieder an napAgent binden. |
Bemerkungen
Der NapAgent löst keinen SoH-Austausch als Ergebnis der Initialisierung aus. Ein Systemintegritäts-Agent muss NotifySoHChange aufrufen, um nach der Initialisierung mit dem NapAgent einen Austausch von SoH-Paketen anzufordern.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 [nur Desktop-Apps] |
| Header |
|
| IDL |
|
| DLL |
|