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