NetworkIsolationRegisterForAppContainerChanges function (netfw.h)

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

Syntax

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

Parameters

[in] 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.

[in] callback

Type: PAC_CHANGES_CALLBACK_FN

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

[in, optional] context

Type: PVOID

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

[out] registrationObject

Type: HANDLE*

Handle to the newly created registration.

Return value

Type: DWORD

Returns ERROR_SUCCESS if successful, or an error value otherwise.

Requirements

Requirement	Value
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