CreateProfile 関数 (userenv.h)
新しいユーザー プロファイルを作成します。
構文
USERENVAPI HRESULT CreateProfile(
[in] LPCWSTR pszUserSid,
[in] LPCWSTR pszUserName,
[out] LPWSTR pszProfilePath,
[in] DWORD cchProfilePath
);
パラメーター
[in] pszUserSid
種類: LPCWSTR
文字列としてのユーザーの SID へのポインター。
[in] pszUserName
種類: LPCWSTR
新しいユーザーのユーザー名です。 この名前は、プロファイル ディレクトリのベース名として使用されます。
[out] pszProfilePath
種類: LPWSTR
この関数が戻るとき、 にはプロファイルの完全なパスへのポインターが含まれます。
[in] cchProfilePath
型: DWORD
pszProfilePath が指すバッファーのサイズ (文字単位)。
戻り値
種類: HRESULT
成功した場合はS_OKを返し、それ以外の場合は次のようなエラー値を返します。
リターン コード | 説明 |
---|---|
|
呼び出し元には、プロファイルを作成するための十分なアクセス許可レベルがありません。 |
|
指定したユーザーのプロファイルが既に存在します。 |
解説
この関数を呼び出すには、呼び出し元に管理者特権が必要です。
要件
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | userenv.h |
Library | Userenv.lib |
[DLL] | Userenv.dll |