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。 若要擷取使用者的漫遊配置檔路徑，請呼叫 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、登錄機碼安全性與訪問許可權和 登錄區中的一節。

呼叫 LoadUserProfile 的服務與應用程式應該檢查使用者是否有漫遊配置檔。 如果使用者有漫遊配置檔，請將其路徑指定為這個結構的 lpProfilePath 成員。

注意

profinfo.h 標頭會根據 UNICODE 預處理器常數的定義，將 PROFILEINFO 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求	價值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器	Windows 2000 Server [僅限傳統型應用程式]
標頭	profinfo.h （包括 Userenv.h）

另請參閱

LoadUserProfile

UnloadUserProfile

使用者配置檔概觀