Поделиться через

Функция DeleteProfileA (userenv.h)

  • Статья

Удаляет профиль пользователя и все параметры, связанные с пользователем, с указанного компьютера. Вызывающий объект должен иметь права администратора для удаления профиля пользователя.

Синтаксис

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

Параметры

[in] lpSidString

Тип: LPCTSTR

Указатель на строку, указывающуюидентификатора безопасности пользователя .

[in, optional] lpProfilePath

Тип: LPCTSTR

Указатель на строку, указывающую путь профиля. Если этот параметр null, функция получает путь из реестра.

[in, optional] lpComputerName

Тип: LPCTSTR

Указатель на строку, указывающую имя компьютера, с которого требуется удалить профиль. Если этот параметр значение NULL, используется имя локального компьютера.

примечание в Windows Vista этот параметр должен быть NULL. Если это не так, эта функция завершается ошибкой с кодом ошибки ERROR_INVALID_PARAMETER.
 

Возвращаемое значение

Тип: BOOL

TRUE в случае успешного выполнения; в противном случае FALSE. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Замечания

DeleteProfile может завершиться ошибкой при передаче идентификатора безопасности учетной записи локальной системы (S-1-5-18).

Заметка

Заголовок userenv.h определяет DeleteProfile как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
целевая платформа Виндоус
заголовка userenv.h
библиотеки Userenv.lib
DLL Userenv.dll

См. также

Обзор профилей пользователей

Справочник по профилям пользователей