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