CreateAppContainerProfile function

Creates a per-user, per-app profile for Windows Store apps.

Syntax

USERENVAPI HRESULT CreateAppContainerProfile(
  PCWSTR              pszAppContainerName,
  PCWSTR              pszDisplayName,
  PCWSTR              pszDescription,
  PSID_AND_ATTRIBUTES pCapabilities,
  DWORD               dwCapabilityCount,
  PSID                *ppSidAppContainerSid
);

Parameters

pszAppContainerName

The name of the app container. To ensure uniqueness, it is recommended that this string contains the app name as well as the publisher. This string can be up to 64 characters in length. Further, it must fit into the pattern described by the regular expression "[-_. A-Za-z0-9]+".

pszDisplayName

The display name. This string can be up to 512 characters in length.

pszDescription

A description for the app container. This string can be up to 2048 characters in length.

pCapabilities

The SIDs that define the requested capabilities.

dwCapabilityCount

The number of SIDs in pCapabilities.

ppSidAppContainerSid

The SID for the profile. This buffer must be freed using the FreeSid function.

Return Value

If this function succeeds, it returns a standard HRESULT code, including the following:

Return code Description
S_OK
The data store was created successfully.
E_ACCESSDENIED
The caller does not have permission to create the profile.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
The application data store already exists.
E_INVALIDARG
The container name is NULL, or the container name, the display name, or the description strings exceed their specified respective limits for length.

Remarks

A profile contains folders and registry storage that are per-user and per-app. The folders have ACLs that prevent them from being accessed by other users and apps. These folders can be accessed by calling SHGetKnownFolderPath.

The function creates a profile for the current user. To create a profile on behalf of another user, you must impersonate that user. To create profiles for multiple users of the same app, you must call CreateAppContainerProfile for each user.

Requirements

   
Windows version Windows 8 [desktop apps only] Windows Server 2012 [desktop apps only]
Target Platform Windows
Header userenv.h
Library Userenv.lib
DLL Userenv.dll

See Also

DeleteAppContainerProfile