Función DeleteAppContainerProfile (userenv.h)

  • Artículo

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