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 de

Puntero a una cadena que especifica el usuario SID.

[in, optional] lpProfilePath

Tipo: LPCTSTR de

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 de

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.

Note As of Windows Vista, este parámetro debe ser NULL. Si no es así, esta función produce un error con el código de error ERROR_INVALID_PARAMETER.
 

Valor devuelto

Tipo: BOOL de

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

Observaciones

DeleteProfile puede producir un error al pasar 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 Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de userenv.h
biblioteca de Userenv.lib
DLL de Userenv.dll

Consulte también

Información general de perfiles de usuario de

de referencia de perfiles de usuario de