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 [デスクトップ アプリのみ]
Header profinfo.h (Userenv.h を含む)

こちらもご覧ください

LoadUserProfile

UnloadUserProfile

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