NetworkIsolationRegisterForAppContainerChanges function

The NetworkIsolationRegisterForAppContainerChanges function is used to register for the delivery of notifications regarding changes to an app container.

Syntax

DWORD NetworkIsolationRegisterForAppContainerChanges(
  DWORD                   flags,
  PAC_CHANGES_CALLBACK_FN callback,
  PVOID                   context,
  HANDLE                  *registrationObject
);

Parameters

flags

Type: DWORD

A bitmask value of control flags which specify when to receive notifications. May contain one or more of the following flags.

Value Meaning
INET_FIREWALL_AC_NONE
0x00
No notifications will be delivered.
INET_FIREWALL_AC_PACKAGE_ID_ONLY
0x01
Notifications will be delivered when an app container is created with a package identifier.
INET_FIREWALL_AC_BINARY
0x02
Notifications will be delivered when an app container is created with a binary path.
INET_FIREWALL_AC_MAX
0x04
Maximum value for testing purposes.

callback

Type: PAC_CHANGES_CALLBACK_FN

Function pointer that will be invoked when a notification is ready for delivery.

context

Type: PVOID

Optional context pointer. This pointer is passed to the callback function along with details of the change.

registrationObject

Type: HANDLE*

Handle to the newly created registration.

Return Value

Type: DWORD

Returns ERROR_SUCCESS if successful, or an error value otherwise.

Requirements

   
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header netfw.h (include Netfw.h)
DLL Firewallapi.dll

See Also

NetworkIsolationUnregisterForAppContainerChanges

PAC_CHANGES_CALLBACK_FN