GetAppContainerFolderPath 函式 (userenv.h)

取得指定之應用程式容器之本機應用程式資料夾的路徑。

語法

USERENVAPI HRESULT GetAppContainerFolderPath(
  [in]  PCWSTR pszAppContainerSid,
  [out] PWSTR  *ppszPath
);

[in] pszAppContainerSid

應用程式容器之 SID 的指標。

[out] ppszPath

當此函式成功傳回時，字串的指標位址會接收本機資料夾的路徑。呼叫 CoTaskMemFree 函式不再需要此字串時，呼叫者必須負責釋放此字串。

此函式會傳回 HRESULT 程式代碼，包括但不限於下列各項：

傳回碼	描述
S_OK	作業已成功完成。
E_INVALIDARG	pszAppContainerSid 或 ppszPath 參數為 NULL。

透過此函式擷取的路徑與您透過 FOLDERID_LocalAppData呼叫SHGetKnownFolderPath函式所得到的路徑相同。

如果已設定線程令牌，此函式會使用目前使用者的應用程式容器。如果未設定線程令牌，此函式會使用與進程識別相關聯的應用程式容器。