AuthzSetAppContainerInformation function (authz.h)

The AuthzSetAppContainerInformation function sets the app container and capability information in a current Authz context. If the passed in context already has an app container security identifier (SID) set or if the passed in context is not a valid app container SID, this function fails.

Syntax

AUTHZAPI BOOL AuthzSetAppContainerInformation(
  [in]           AUTHZ_CLIENT_CONTEXT_HANDLE hAuthzClientContext,
  [in]           PSID                        pAppContainerSid,
  [in]           DWORD                       CapabilityCount,
  [in, optional] PSID_AND_ATTRIBUTES         pCapabilitySids
);

Parameters

[in] hAuthzClientContext

The handle to the client context to which the given app container SID and capability SIDs will be added.

[in] pAppContainerSid

The app container SID.

[in] CapabilityCount

The number of capability SIDs to be added. This value can be zero if no capability is to be added.

[in, optional] pCapabilitySids

The capability SIDs to be added to the context. This value must be NULL when the CapabilityCount parameter is zero.

Return value

If the function succeeds, it returns TRUE.

If the function fails, it returns FALSE. To get extended error information, call GetLastError.

Requirements

Requirement Value
Minimum supported client Windows 8 [desktop apps only]
Minimum supported server Windows Server 2012 [desktop apps only]
Target Platform Windows
Header authz.h
Library Authz.lib
DLL Authz.dll