Fonction CreateAppContainerProfile (userenv.h)

Crée un profil par utilisateur et par application pour un AppContainer.

Syntaxe

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

Paramètres

[in] pszAppContainerName

Nom du conteneur d’application. Pour garantir l’unicité, cette chaîne doit idéalement contenir le nom de l’application ainsi que l’éditeur. Cette chaîne peut avoir jusqu’à 64 caractères. En outre, il doit s’intégrer au modèle décrit par l’expression régulière « [-_. A-Za-z0-9]+ ».

[in] pszDisplayName

Le nom d’affichage. Cette chaîne peut avoir jusqu’à 512 caractères.

[in] pszDescription

Description du conteneur d’application. Cette chaîne peut avoir jusqu’à 2 048 caractères.

[in] pCapabilities

Les SID qui définissent les fonctionnalités UWP demandées (le cas échéant).

[in] dwCapabilityCount

Nombre de SID dans pCapabilities.

[out] ppSidAppContainerSid

SID du profil. Cette mémoire tampon doit être libérée à l’aide de la fonction FreeSid.

Valeur retournée

Si cette fonction réussit, elle retourne un code HRESULT standard, y compris les éléments suivants :

Remarques

Un profil contient des dossiers et un stockage de Registre par utilisateur et par application. Les dossiers ont des listes de contrôle d’accès qui les empêchent d’accéder à d’autres utilisateurs et applications. Ces dossiers sont accessibles en appelant SHGetKnownFolderPath.

La fonction crée un profil pour l’utilisateur actuel. Pour créer un profil pour le compte d’un autre utilisateur, vous devez emprunter l’identité de cet utilisateur. Pour créer des profils pour plusieurs utilisateurs de la même application, vous devez appeler CreateAppContainerProfile pour chaque utilisateur.

Configuration requise

Voir aussi

• DeleteAppContainerProfile