Skip to main content
NetworkIsolationRegisterForAppContainerChanges function

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_opt_ PVOID                   context,
  _Out_    HANDLE                  *registrationObject
);

Parameters

flags [in]

Type: DWORD

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

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

Type: PAC_CHANGES_CALLBACK_FN

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

context [in, optional]

Type: PVOID

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

registrationObject [out]

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]

Header

Netfw.h

DLL

Firewallapi.dll

See also

PAC_CHANGES_CALLBACK_FN
NetworkIsolationUnregisterForAppContainerChanges