共用方式為


LoadUserProfileA 函式 (userenv.h)

載入指定的使用者設定檔。 設定檔可以是 本機使用者設定檔漫遊使用者設定檔

語法

USERENVAPI BOOL LoadUserProfileA(
  [in]      HANDLE         hToken,
  [in, out] LPPROFILEINFOA lpProfileInfo
);

參數

[in] hToken

類型: HANDLE

使用者權杖,由 LogonUserCreateRestrictedTokenDuplicateTokenOpenProcessTokenOpenThreadToken 函式傳回。 權杖必須具有 TOKEN_QUERYTOKEN_IMPERSONATETOKEN_DUPLICATE 存取權。 如需詳細資訊,請參閱 Access-Token 物件的存取權限

[in, out] lpProfileInfo

類型: LPPROFILEINFO

PROFILEINFO結構的指標。 LoadUserProfile會失敗,如果結構的dwSize成員未設定 sizeof(PROFILEINFO) 為 或lpUserName成員為Null,則會傳回ERROR_INVALID_PARAMETER。 如需詳細資訊,請參閱<備註>。

傳回值

類型: BOOL

如果 成功,則為 TRUE;否則為 FALSE。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

如果lpProfileInfodwSize成員未設定為 sizeof(PROFILEINFO)lpUserName成員為Null,則函式會失敗並傳回ERROR_INVALID_PARAMETER。

備註

當使用者以互動方式登入時,系統會自動載入使用者的設定檔。 如果服務或應用程式模擬使用者,系統就不會載入使用者的設定檔。 因此,服務或應用程式應該使用 LoadUserProfile載入使用者的設定檔。

呼叫 LoadUserProfile 的服務與應用程式應該檢查使用者是否有漫遊設定檔。 如果使用者有漫遊設定檔,請將其路徑指定為PROFILEINFOlpProfilePath成員。 若要擷取使用者的漫遊設定檔路徑,您可以呼叫 NetUserGetInfo 函式,並指定資訊層級 3 或 4。

成功傳回時,PROFILEINFOhProfile成員是開啟至使用者 hive 根目錄的登錄機碼控制碼。 它已以完整存取權 (KEY_ALL_ACCESS) 開啟。 如果模擬使用者的服務需要讀取或寫入使用者的登錄檔,請使用此控制碼,而不是 HKEY_CURRENT_USER。 請勿關閉 hProfile 控制碼。 而是將它傳遞至 UnloadUserProfile 函式 。 此函式會關閉控制碼。 您應該確定使用者登錄區中的所有機碼控制碼都會關閉。 如果您未關閉所有開啟的登錄控制碼,則使用者設定檔無法卸載。 如需詳細資訊,請參閱 登錄機碼安全性和存取權限登錄 Hives

請注意,您必須先使用LoadUserProfile函式將使用者的登錄區載入HKEY_USERS登錄機碼,再呼叫CreateProcessAsUser。 這是因為 CreateProcessAsUser 不會將指定的使用者設定檔載入 HKEY_USERS。 這表示 存取HKEY_CURRENT_USER 登錄機碼中的資訊,可能不會產生與一般互動式登入一致的結果。

呼叫進程必須具有 SE_RESTORE_NAMESE_BACKUP_NAME 許可權。 如需詳細資訊,請參閱 使用特殊許可權執行

從 Windows XP Service Pack 2 (SP2) 和 Windows Server 2003 開始,呼叫端必須是系統管理員或 LocalSystem 帳戶。 呼叫端不足以模擬系統管理員或 LocalSystem 帳戶。

注意

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

需求

   
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 userenv.h
程式庫 Userenv.lib
Dll Userenv.dll

另請參閱

PROFILEINFO

UnloadUserProfile

使用者設定檔概觀

使用者設定檔參考