DeleteProfileA 函式（userenv.h）

從指定的計算機刪除使用者配置檔和所有使用者相關設定。呼叫端必須具有系統管理許可權，才能刪除使用者的配置檔。

語法

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

[in] lpSidString

類型：LPCTSTR

字串的指標，指定使用者 SID。

[in, optional] lpProfilePath

類型：LPCTSTR

指定配置檔路徑之字串的指標。如果此參數 NULL，則函式會從登錄取得路徑。

[in, optional] lpComputerName

類型：LPCTSTR

字串的指標，指定要刪除設定檔的計算機名稱。如果此參數 NULL，則會使用本機計算機名稱。

注意從 Windows Vista 開始，此參數必須 NULL。如果不是，此函式會失敗，錯誤碼ERROR_INVALID_PARAMETER。

類型：BOOL

如果成功，TRUE;否則，FALSE。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

當傳遞本機系統帳戶的安全性標識碼（S-1-5-18）時，DeleteProfile 可能會失敗。

注意

userenv.h 標頭會將DeleteProfile定義為別名，根據UNICODE預處理器常數的定義，自動選取此函式的ANSI或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平臺	窗戶
標頭	userenv.h
連結庫	Userenv.lib
DLL	Userenv.dll