Función DeleteAppContainerProfile (userenv.h)

Elimina el perfil especificado por usuario y por aplicación.

Nota La eliminación de un perfil inexistente devuelve un resultado correcto.

 

Sintaxis

USERENVAPI HRESULT DeleteAppContainerProfile(
  [in] PCWSTR pszAppContainerName
);

Parámetros

[in] pszAppContainerName

Nombre dado al perfil en la llamada a la función CreateAppContainerProfile . Esta cadena tiene como máximo 64 caracteres de longitud y se ajusta al patrón descrito por la expresión regular "[-_. A-Za-z0-9]+".

Valor devuelto

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

Código devuelto	Descripción
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Si se llama al método desde dentro de un contenedor de aplicaciones.
S_OK	El perfil se eliminó correctamente.
E_INVALIDARG	Si el nombre del contenedor es NULL o si supera su límite de longitud especificado.

Comentarios

Para garantizar los mejores resultados, cierre todos los identificadores de archivo en las ubicaciones de almacenamiento de perfiles antes de llamar a la función DeleteAppContainerProfile . De lo contrario, es posible que esta función no pueda quitar completamente las ubicaciones de almacenamiento del perfil.

Esta función elimina el perfil del usuario actual. Para eliminar el perfil de otro usuario, debe suplantar a ese usuario.

Si se produce un error en la función, el estado del perfil no está definido y debe llamar a DeleteAppContainerProfile de nuevo para completar la operación.

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

CreateAppContainerProfile