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 を含む) |