PROFILEINFOA 構造体 (profinfo.h)

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

構文

typedef struct _PROFILEINFOA {
  DWORD             dwSize;
  DWORD             dwFlags;
  MIDL_STRING LPSTR lpUserName;
  MIDL_STRING LPSTR lpProfilePath;
  MIDL_STRING LPSTR lpDefaultPath;
  MIDL_STRING LPSTR lpServerName;
  MIDL_STRING LPSTR lpPolicyPath;
#if ...
  ULONG_PTR         hProfile;
#else
  HANDLE            hProfile;
#endif
} PROFILEINFOA, *LPPROFILEINFOA;

メンバーズ

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 ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして PROFILEINFO を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

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

関連項目

LoadUserProfile の

UnloadUserProfile の

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