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)

另請參閱

LoadUserProfile

UnloadUserProfile

使用者配置檔概觀