UnloadUserProfile

LoadUserProfile 関数で読み込まれたユーザーのプロファイルをアンロードする。呼び出し側はコンピューター上で管理者権限を持っている必要がある。詳細は LoadUserProfile 関数の解説セクションを参照。

UnloadUserProfile hToken, hProfile

hToken : [intptr] 型: HANDLE LogonUser、CreateRestrictedToken、DuplicateToken、OpenProcessToken、OpenThreadToken 関数から返されるユーザーのトークン。このトークンには TOKEN_IMPERSONATE と TOKEN_DUPLICATE のアクセス権が必要である。詳細は Access Rights for Access-Token Objects を参照。
hProfile : [intptr] 型: HANDLE レジストリキーへのハンドル。この値は PROFILEINFO 構造体の hProfile メンバーである。詳細は LoadUserProfile の解説セクションおよび Registry Key Security and Access Rights を参照。

(プラグイン / モジュール : userenv.dll)

解説

LoadUserProfile
関数で読み込まれたユーザーのプロファイルをアンロードする。呼び出し側はコンピューター上で管理者権限を持っている必要がある。詳細は
LoadUserProfile 関数の解説セクションを参照。

[戻り値]
型: BOOL 成功した場合は TRUE、それ以外は FALSE を返す。拡張エラー情報を取得するには GetLastError
を呼び出す。

[備考]
UnloadUserProfile
を呼び出す前に、ユーザーのレジストリハイブ内で開いたすべてのキーハンドルが閉じられていることを確認する必要がある。すべての開いているレジストリハンドルを閉じないと、ユーザープロファイルのアンロードに失敗する。詳細は
Registry Key Security and Access Rights および Registry Hives
を参照。管理者権限を必要とする関数呼び出しの詳細については、Running with Special Privileges を参照。

情報