UnloadUserProfile 函式 (userenv.h)

卸除 LoadUserProfile 函式所載入的使用者配置檔。呼叫端必須具有電腦上的系統管理許可權。如需詳細資訊，請參閱 LoadUserProfile 函式的一節。

語法

USERENVAPI BOOL UnloadUserProfile(
  [in] HANDLE hToken,
  [in] HANDLE hProfile
);

[in] hToken

類型： HANDLE

使用者令牌，從 LogonUser、CreateRestrictedToken、DuplicateToken、OpenProcessToken 或 OpenThreadToken 函式傳回。令牌必須具有 TOKEN_IMPERSONATE 和 TOKEN_DUPLICATE 存取權。如需詳細資訊，請參閱 Access-Token 對象的訪問許可權。

[in] hProfile

類型： HANDLE

登錄機碼的句柄。這個值是 PROFILEINFO 結構的 hProfile 成員。如需詳細資訊，請參閱 LoadUserProfile 和登錄機碼安全性和訪問許可權的一節。

類型： BOOL

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

呼叫 UnloadUserProfile 之前，您應該確定您已在使用者的登錄區中開啟的所有機碼句柄都會關閉。如果您未關閉所有開啟的登錄句柄，則使用者配置檔無法卸除。如需詳細資訊，請參閱登錄機碼安全性和訪問許可權和登錄 Hives。

如需呼叫需要系統管理員許可權之函式的詳細資訊，請參閱以特殊許可權執行。

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	userenv.h
程式庫	Userenv.lib
Dll	Userenv.dll