PROFILEINFOW 構造体 (profinfo.h)

  • [アーティクル]

ユーザー プロファイルの読み込みまたはアンロード時に使用される情報が含まれます。

構文

typedef struct _PROFILEINFOW {
  DWORD              dwSize;
  DWORD              dwFlags;
  MIDL_STRING LPWSTR lpUserName;
  MIDL_STRING LPWSTR lpProfilePath;
  MIDL_STRING LPWSTR lpDefaultPath;
  MIDL_STRING LPWSTR lpServerName;
  MIDL_STRING LPWSTR lpPolicyPath;
#if ...
  ULONG_PTR          hProfile;
#else
  HANDLE             hProfile;
#endif
} PROFILEINFOW, *LPPROFILEINFOW;

メンバー

dwSize

型: DWORD

この構造体のサイズ (バイト単位)。

dwFlags

型: DWORD

このメンバーには、次のいずれかのフラグを指定できます。

PI_NOUI

プロファイル エラー メッセージが表示されないようにします。

PI_APPLYPOLICY

サポートされていません。

lpUserName

種類: LPTSTR

ユーザーの名前へのポインター。 このメンバーは、新しいプロファイルを格納するディレクトリのベース名として使用されます。

lpProfilePath

種類: LPTSTR

ローミング ユーザー プロファイル パスへのポインター。 ユーザーがローミング プロファイルを持っていない場合、このメンバーは NULL にすることができます。 ユーザーのローミング プロファイル パスを取得するには、情報レベル 3 または 4 を指定して NetUserGetInfo 関数を呼び出します。 詳細については、「解説」を参照してください。

lpDefaultPath

種類: LPTSTR

既定のユーザー プロファイル パスへのポインター。 このメンバーは NULL にすることができます。

lpServerName

種類: LPTSTR

検証ドメイン コントローラーの名前へのポインター (NetBIOS 形式)。

lpPolicyPath

種類: LPTSTR

使用せず、NULL に設定 します。

hProfile

型: HANDLE

HKEY_CURRENT_USER レジストリ サブツリーへのハンドル。 詳細については、「解説」を参照してください。

注釈

パスを指定する場合は、環境変数を使用しないでください。 LoadUserProfile 関数は、%username%などの環境変数をパスで展開しません。

LoadUserProfile 呼び出しが正常に返されると、hProfile メンバーは、フル アクセス (KEY_ALL_ACCESS) で開かれた、ユーザーのサブツリーのルートに開かれたレジストリ キー ハンドルを受け取ります。 詳細については、「 LoadUserProfile」、「 レジストリ キーのセキュリティとアクセス権」、「レジストリハイブ」の「解説」セクションを参照してください。

LoadUserProfile を呼び出すサービスとアプリケーションは、ユーザーがローミング プロファイルを持っているかどうかを確認するためにチェックする必要があります。 ユーザーがローミング プロファイルを持っている場合は、そのパスをこの構造体の lpProfilePath メンバーとして指定します。

注意

profinfo.h ヘッダーは PROFILEINFO を別名として定義します。これは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイル エラーまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
Header profinfo.h (Userenv.h を含む)

こちらもご覧ください

LoadUserProfile

UnloadUserProfile

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