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を返し、それ以外の場合は次のようなエラー値を返します。

リターン コード 説明
E_ACCESSDENIED
 呼び出し元には、プロファイルを作成するための十分なアクセス許可レベルがありません。
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)
 指定したユーザーのプロファイルが既に存在します。

解説

この関数を呼び出すには、呼び出し元に管理者特権が必要です。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー userenv.h
Library Userenv.lib
[DLL] Userenv.dll