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 を呼び出す前に、ユーザーのレジストリ ハイブで開いたキーに対するすべてのハンドルが閉じられるようにする必要があります。 開いているレジストリ ハンドルをすべて閉じなかった場合、ユーザーのプロファイルはアンロードに失敗します。 詳細については、「レジストリ キーのセキュリティとアクセス権」および「レジストリ ハイブ」を参照してください。

管理者特権を必要とする関数の呼び出しの詳細については、「 特別な特権で実行する」を参照してください。

要件

こちらもご覧ください

LoadUserProfile

PROFILEINFO

ユーザー プロファイルの概要

ユーザー プロファイル リファレンス