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 |