NetworkIsolationEnumAppContainers function (netfw.h)

The NetworkIsolationEnumAppContainers function enumerates all of the app containers that have been created in the system.

Syntax

DWORD NetworkIsolationEnumAppContainers(
  [in]  DWORD                        Flags,
  [out] DWORD                        *pdwNumPublicAppCs,
  [out] PINET_FIREWALL_APP_CONTAINER *ppPublicAppCs
);

Parameters

[in] Flags

Type: DWORD

May be set to NETISO_FLAG_FORCE_COMPUTE_BINARIES to ensure that all binaries are computed before the app container is returned. This flag should be set if the caller requires up-to-date and complete information on app container binaries. If this flag is not set, returned data may be stale or incomplete.

See NETISO_FLAG for more information.

[out] pdwNumPublicAppCs

Type: DWORD*

The number of app containers in the ppPublicAppCs member.

[out] ppPublicAppCs

Type: PINET_FIREWALL_APP_CONTAINER*

The list of app container structure elements.

Return value

Type: DWORD

Returns ERROR_SUCCESS if successful, or an error value otherwise.

ERROR_OUTOFMEMORY will be returned if memory is unavailable.

Remarks

If no app containers are installed on the system, ERROR_SUCCESS will still be returned (and ppPublicAppCs will be empty). If ppPublicAppCs is not empty, NetworkIsolationFreeAppContainers should be used to free the memory when you are done using it.

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

INET_FIREWALL_APP_CONTAINER

NETISO_FLAG