NetworkIsolationRegisterForAppContainerChanges-Funktion (netfw.h)

Artikel
02/29/2024

Die NetworkIsolationRegisterForAppContainerChanges-Funktion wird verwendet, um sich für die Übermittlung von Benachrichtigungen zu Änderungen an einem App-Container zu registrieren.

Syntax

DWORD NetworkIsolationRegisterForAppContainerChanges(
  [in]           DWORD                   flags,
  [in]           PAC_CHANGES_CALLBACK_FN callback,
  [in, optional] PVOID                   context,
  [out]          HANDLE                  *registrationObject
);

Parameter

[in] flags

Art: DWORD

Ein Bitmaskenwert von Steuerelementflags, die angeben, wann Benachrichtigungen empfangen werden sollen. Kann eines oder mehrere der folgenden Flags enthalten.

Wert	Bedeutung
INET_FIREWALL_AC_NONE 0x00	Es werden keine Benachrichtigungen übermittelt.
INET_FIREWALL_AC_PACKAGE_ID_ONLY 0x01	Benachrichtigungen werden übermittelt, wenn ein App-Container mit einem Paketbezeichner erstellt wird.
INET_FIREWALL_AC_BINARY 0x02	Benachrichtigungen werden übermittelt, wenn ein App-Container mit einem binären Pfad erstellt wird.
INET_FIREWALL_AC_MAX 0x04	Maximalwert für Testzwecke.

[in] callback

Typ: PAC_CHANGES_CALLBACK_FN

Funktionszeiger, der aufgerufen wird, wenn eine Benachrichtigung zur Übermittlung bereit ist.

[in, optional] context

Typ: PVOID

Optionaler Kontextzeiger. Dieser Zeiger wird zusammen mit Details der Änderung an die Rückruffunktion übergeben.

[out] registrationObject

Typ: HANDLE*

Handle für die neu erstellte Registrierung.

Rückgabewert

Art: DWORD

Gibt bei erfolgreicher Ausführung ERROR_SUCCESS oder andernfalls einen Fehlerwert zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	netfw.h (netfw.h einschließen)
DLL	Firewallapi.dll

Weitere Informationen

NetworkIsolationUnregisterForAppContainerChanges

PAC_CHANGES_CALLBACK_FN

Share via