共用方式為

CreateAppContainerProfile 函式 (userenv.h)

  • 發行項

建立 AppContainer 的每個使用者、個別應用程式配置檔。

語法

USERENVAPI HRESULT CreateAppContainerProfile(
  [in]  PCWSTR              pszAppContainerName,
  [in]  PCWSTR              pszDisplayName,
  [in]  PCWSTR              pszDescription,
  [in]  PSID_AND_ATTRIBUTES pCapabilities,
  [in]  DWORD               dwCapabilityCount,
  [out] PSID                *ppSidAppContainerSid
);

參數

[in] pszAppContainerName

應用程式容器的名稱。 為了確保唯一性，此字串最好包含應用程式名稱和發行者。 此字串長度最多可達 64 個字元。 此外，它必須符合正則表達式 “[-_. A-Za-z0-9]+”。

[in] pszDisplayName

顯示名稱。 此字串長度最多可達 512 個字元。

[in] pszDescription

應用程式容器的描述。 此字串長度最多可達 2048 個字元。

[in] pCapabilities

如果適用的話，定義要求的UWP功能 (的SID) 。

[in] dwCapabilityCount

pCapabilities 中的 SID 數目。

[out] ppSidAppContainerSid

配置檔的 SID。 這個緩衝區必須使用 FreeSid函式釋放。

傳回值

如果此函式成功，則會傳回標準 HRESULT 程式代碼，包括下列專案：

傳回碼 描述
S_OK
 已成功建立數據存放區。
E_ACCESSDENIED
 呼叫端沒有建立配置檔的許可權。
HRESULT_FROM_WIN32 (ERROR_ALREADY_EXISTS)
應用程式資料存放區已經存在。
E_INVALIDARG
 容器名稱為 NULL，或容器名稱、顯示名稱或描述字串超過其指定長度的個別限制。

備註

配置檔包含每一使用者和個別應用程式的資料夾和登錄記憶體。 資料夾具有 ACL，可防止其他使用者和應用程式存取它們。 呼叫 SHGetKnownFolderPath即可存取這些資料夾。

函式會建立目前使用者的配置檔。 若要代表其他使用者建立配置檔，您必須模擬該使用者。 若要為相同應用程式的多個使用者建立配置檔，您必須為每個使用者呼叫 CreateAppContainerProfile 。

規格需求

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

另請參閱