Compartilhar via

Função DeleteAppContainerProfile (userenv.h)

Exclui o perfil especificado por usuário, por aplicativo.

Nota A exclusão de um perfil inexistente retorna êxito.

 

Sintaxe

USERENVAPI HRESULT DeleteAppContainerProfile(
  [in] PCWSTR pszAppContainerName
);

Parâmetros

[in] pszAppContainerName

O nome dado ao perfil na chamada para a função CreateAppContainerProfile . Essa cadeia de caracteres tem no máximo 64 caracteres e se encaixa no padrão descrito pela expressão regular "[-_. A-Za-z0-9]+".

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
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 Se o método for chamado de dentro de um contêiner de aplicativo.
S_OK
 O perfil foi excluído com êxito.
E_INVALIDARG
 Se o nome do contêiner for NULL ou se exceder o limite especificado de comprimento.

Comentários

Para garantir os melhores resultados, feche todos os identificadores de arquivo nos locais de armazenamento de perfil antes de chamar a função DeleteAppContainerProfile . Caso contrário, essa função pode não ser capaz de remover completamente os locais de armazenamento do perfil.

Essa função exclui o perfil do usuário atual. Para excluir o perfil de outro usuário, você deve representar esse usuário.

Se a função falhar, o status do perfil será indeterminado e você deverá chamar DeleteAppContainerProfile novamente para concluir a operação.

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

CreateAppContainerProfile

  • Last updated on