Share via

Função CreateAppContainerProfile (userenv.h)

  • Artigo

Cria um perfil por usuário por aplicativo para um AppContainer.

Sintaxe

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

O nome do contêiner do aplicativo. Para garantir a exclusividade, essa cadeia de caracteres deve conter o nome do aplicativo, bem como o editor. Essa cadeia de caracteres pode ter até 64 caracteres de comprimento. Além disso, ele deve se ajustar ao padrão descrito pela expressão regular "[-_. A-Za-z0-9]+".

[in] pszDisplayName

O nome para exibição. Essa cadeia de caracteres pode ter até 512 caracteres.

[in] pszDescription

Uma descrição para o contêiner do aplicativo. Essa cadeia de caracteres pode ter até 2.048 caracteres.

[in] pCapabilities

Os SIDs que definem os recursos UWP solicitados (se aplicável).

[in] dwCapabilityCount

O número de SIDs em pCapabilities.

[out] ppSidAppContainerSid

O SID do perfil. Esse buffer deve ser liberado usando a função FreeSid.

Retornar valor

Se essa função for bem-sucedida, ela retornará um código HRESULT padrão, incluindo o seguinte:

Código de retorno Descrição
S_OK
 O armazenamento de dados foi criado com êxito.
E_ACCESSDENIED
 O chamador não tem permissão para criar o perfil.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
 O armazenamento de dados do aplicativo já existe.
E_INVALIDARG
 O nome do contêiner é NULL ou o nome do contêiner, o nome de exibição ou as cadeias de caracteres de descrição excedem seus respectivos limites especificados para comprimento.

Comentários

Um perfil contém pastas e armazenamento do Registro que são por usuário e por aplicativo. As pastas têm ACLs que os impedem de serem acessados por outros usuários e aplicativos. Essas pastas podem ser acessadas chamando SHGetKnownFolderPath.

A função cria um perfil para o usuário atual. Para criar um perfil em nome de outro usuário, você deve representar esse usuário. Para criar perfis para vários usuários do mesmo aplicativo, você deve chamar CreateAppContainerProfile para cada usuário.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho userenv.h
Biblioteca Userenv.lib
DLL Userenv.dll

Confira também