Compartir a través de

Función CreateAppContainerProfile (userenv.h)

  • Artículo

Crea un perfil por usuario y por aplicación para un AppContainer.

Sintaxis

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

Parámetros

[in] pszAppContainerName

Nombre del contenedor de aplicaciones. Para garantizar la unicidad, esta cadena debe contener idealmente el nombre de la aplicación, así como el publicador. Esta cadena puede tener hasta 64 caracteres de longitud. Además, debe ajustarse al patrón descrito por la expresión regular "[-_. A-Za-z0-9]+".

[in] pszDisplayName

El nombre para mostrar. Esta cadena puede tener hasta 512 caracteres de longitud.

[in] pszDescription

Descripción del contenedor de aplicaciones. Esta cadena puede tener hasta 2048 caracteres de longitud.

[in] pCapabilities

Los SID que definen las funcionalidades de UWP solicitadas (si procede).

[in] dwCapabilityCount

Número de SID en pCapabilities.

[out] ppSidAppContainerSid

SiD del perfil. Este búfer debe liberarse mediante la función FreeSid.

Valor devuelto

Si esta función se ejecuta correctamente, devuelve un código HRESULT estándar, incluido lo siguiente:

Código devuelto Descripción
S_OK
 El almacén de datos se creó correctamente.
E_ACCESSDENIED
 El autor de la llamada no tiene permiso para crear el perfil.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
 El almacén de datos de la aplicación ya existe.
E_INVALIDARG
 El nombre del contenedor es NULL o el nombre del contenedor, el nombre para mostrar o las cadenas de descripción superan sus límites respectivos especificados para la longitud.

Comentarios

Un perfil contiene carpetas y almacenamiento del Registro que son por usuario y por aplicación. Las carpetas tienen ACL que impiden que otros usuarios y aplicaciones accedan a ellas. Se puede acceder a estas carpetas llamando a SHGetKnownFolderPath.

La función crea un perfil para el usuario actual. Para crear un perfil en nombre de otro usuario, debe suplantar a ese usuario. Para crear perfiles para varios usuarios de la misma aplicación, debe llamar a CreateAppContainerProfile para cada usuario.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado userenv.h
Library Userenv.lib
Archivo DLL Userenv.dll

Consulte también