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。 若要擷取使用者的漫遊配置檔路徑，請呼叫 NetUserGetInfo 函式，並指定資訊層級 3 或 4。 如需詳細資訊，請參閱＜備註＞。
lpDefaultPath
類型： LPTSTR
預設使用者配置檔路徑的指標。 這個成員可以是 NULL。
lpServerName
類型： LPTSTR
以 NetBIOS 格式驗證域控制器名稱的指標。
lpPolicyPath
類型： LPTSTR
未使用，請將 設定為 NULL。
hProfile
類型： HANDLE
HKEY_CURRENT_USER登錄子樹的句柄。 如需詳細資訊，請參閱＜備註＞。
備註
指定路徑時，請勿使用環境變數。 LoadUserProfile 函式不會展開路徑中的環境變數，例如 %username%。
當 LoadUserProfile 呼叫成功傳回時， hProfile 成員會收到開啟至使用者子樹根目錄的登錄機碼句柄，以完整存取權開啟 (KEY_ALL_ACCESS) 。 如需詳細資訊，請參閱 LoadUserProfile、 登錄機碼安全性和訪問許可權和 登錄 Hives 中的一節。
呼叫 LoadUserProfile 的服務與應用程式應該檢查使用者是否有漫遊配置檔。 如果使用者有漫遊配置檔，請將其路徑指定為此結構的 lpProfilePath 成員。
注意
profinfo.h 標頭會將 PROFILEINFO 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 標頭 | profinfo.h (包括 Userenv.h) |