Edit

Share via

NetworkIsolationSetupAppContainerBinaries function (netfw.h)

  • Article

The NetworkIsolationSetupAppContainerBinaries function is used by software installers to provide information about the image paths of applications that are running in an app container. This information is provided to third-party firewall applications about the applications in order to enhance user experience and security decisions.

Syntax

HRESULT NetworkIsolationSetupAppContainerBinaries(
  [in] PSID    applicationContainerSid,
  [in] LPCWSTR packageFullName,
  [in] LPCWSTR packageFolder,
  [in] LPCWSTR displayName,
  [in] BOOL    bBinariesFullyComputed,
  [in] LPCWSTR *binaries,
  [in] DWORD   binariesCount
);

Parameters

[in] applicationContainerSid

Type: PSID

The package identifier of the app container.

[in] packageFullName

Type: LPCWSTR

A string representing the package identity of the app that owns this app container. Contains the 5-part tuple as individual fields (name, version, architecture, resourceid, publisher).

[in] packageFolder

Type: LPCWSTR

The file location of the app that owns this app container.

[in] displayName

Type: LPCWSTR

The friendly name of the app container.

[in] bBinariesFullyComputed

Type: BOOL

True if the binary files are being provided by the caller; otherwise, false.

[in] binaries

Type: LPCWSTR*

An array of paths to the applications running in the app container.

[in] binariesCount

Type: DWORD

The number of paths contained in the binaries parameter.

Return value

Type: HRESULT

If the function succeeds, it returns S_OK.

If the function fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

Remarks

Applications creating an app container can use NetworkIsolationSetupAppContainerBinaries to provide third-party firewall applications with the direct path to applications running inside that app container.

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