Compartir a través de

Función DeleteProfileA (userenv.h)

  • Artículo

Elimina el perfil de usuario y toda la configuración relacionada con el usuario del equipo especificado. El autor de la llamada debe tener privilegios administrativos para eliminar el perfil de un usuario.

Sintaxis

USERENVAPI BOOL DeleteProfileA(
  [in]           LPCSTR lpSidString,
  [in, optional] LPCSTR lpProfilePath,
  [in, optional] LPCSTR lpComputerName
);

Parámetros

[in] lpSidString

Tipo: LPCTSTR

Puntero a una cadena que especifica el SID de usuario.

[in, optional] lpProfilePath

Tipo: LPCTSTR

Puntero a una cadena que especifica la ruta de acceso del perfil. Si este parámetro es NULL, la función obtiene la ruta de acceso del Registro.

[in, optional] lpComputerName

Tipo: LPCTSTR

Puntero a una cadena que especifica el nombre del equipo desde el que se va a eliminar el perfil. Si este parámetro es NULL, se usa el nombre del equipo local.

Nota A partir de Windows Vista, este parámetro debe ser NULL. Si no es así, se produce un error en esta función con el código de error ERROR_INVALID_PARAMETER.
 

Valor devuelto

Tipo: BOOL

TRUE si se ejecuta correctamente; de lo contrario, FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

DeleteProfile puede producir un error cuando se pasa el identificador de seguridad (SID) de la cuenta del sistema local (S-1-5-18).

Nota

El encabezado userenv.h define DeleteProfile como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado userenv.h
Library Userenv.lib
Archivo DLL Userenv.dll

Consulte también

Introducción a los perfiles de usuario

Referencia de perfiles de usuario