InitializeNapAgentNotifier-Funktion

Artikel
06/13/2023

Hinweis

Die Netzwerkzugriffsschutzplattform ist ab Windows 10

Die InitializeNapAgentNotifier-Funktion abonniert den Aufrufprozess für NapAgent-Zustandsänderungsbenachrichtigungen und Benachrichtigungen zur Änderung des Zustands unter Quarantäne. Diese Benachrichtigungen werden vom NapAgent-Dienst bereitgestellt.

Syntax

NAPAPI HRESULT WINAPI InitializeNapAgentNotifier(
  _In_ NapNotifyType type,
  _In_ HANDLE        hNotifyEvent
);

Parameter

Geben Sie [in] ein.: Ein NapNotifyType-Wert , der den Typ der zu empfangenden Dienstbenachrichtigungen angibt.
hNotifyEvent [in]: Ein Ereignishandle, das für Benachrichtigungen verwendet wird. Der Aufrufer muss ein geöffnetes Handle an den hNotifyEvent-Parameter übergeben. Der Aufrufer muss auch das Ereignishandle schließen, wenn es nicht mehr benötigt wird.

Rückgabewert

Rückgabecode	Beschreibung
S_OK	Die Initialisierung wurde erfolgreich abgeschlossen.
E_FAIL	Fehler bei der Initialisierung.
ERROR_ALREADY_INITIALIZED	Der Prozess hat bereits NapAgent-Dienstbenachrichtigungen des angegebenen Typs abonniert.
E_INVALIDARG	Ein ungültiges Argument wurde übergeben.

Bemerkungen

Diese Funktion ist nicht threadsicher.

Jeder Prozess, der ein Abonnement für napAgent-Dienstbenachrichtigungen des angegebenen Typs erfordert, muss InitializeNapAgentNotifier aufrufen, um Benachrichtigungen zu abonnieren. Wenn ein Prozess mehrere Benachrichtigungstypen abonnieren muss, muss er initializeNapAgentNotifier einmal für jeden Benachrichtigungstyp aufrufen.

Sobald für einen Prozess keine weiteren Benachrichtigungen erforderlich sind, muss der Prozess UninitializeNapAgentNotifier für den angegebenen Typ aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Header	NapUtil.h
DLL	Qutil.dll

Weitere Informationen

UninitializeNapAgentNotifier

Freigeben über