Fungsi CreateAppContainerProfile (userenv.h)

Artikel
03/13/2024

Membuat profil per pengguna per aplikasi untuk AppContainer.

Sintaks

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

Parameter

[in] pszAppContainerName

Nama kontainer aplikasi. Untuk memastikan keunikan, string ini idealnya harus berisi nama aplikasi serta penerbit. Panjang string ini bisa hingga 64 karakter. Selanjutnya, itu harus sesuai dengan pola yang dijelaskan oleh ekspresi reguler "[-_. A-Za-z0-9]+".

[in] pszDisplayName

Nama tampilan. Panjang string ini bisa hingga 512 karakter.

[in] pszDescription

Deskripsi untuk kontainer aplikasi. Panjang string ini bisa hingga 2048 karakter.

[in] pCapabilities

SID yang menentukan kemampuan UWP yang diminta (jika berlaku).

[in] dwCapabilityCount

Jumlah SID dalam pCapabilities.

[out] ppSidAppContainerSid

SID untuk profil. Buffer ini harus dikosongkan menggunakan fungsi FreeSid.

Nilai kembali

Jika fungsi ini berhasil, maka ia mengembalikan kode HRESULT standar, termasuk yang berikut:

Menampilkan kode	Deskripsi
S_OK	Penyimpanan data berhasil dibuat.
E_ACCESSDENIED	Pemanggil tidak memiliki izin untuk membuat profil.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)	Penyimpanan data aplikasi sudah ada.
E_INVALIDARG	Nama kontainer adalah NULL, atau nama kontainer, nama tampilan, atau string deskripsi melebihi batas masing-masing yang ditentukan untuk panjangnya.

Keterangan

Profil berisi folder dan penyimpanan registri per pengguna dan per aplikasi. Folder memiliki ACL yang mencegahnya diakses oleh pengguna dan aplikasi lain. Folder ini dapat diakses dengan memanggil SHGetKnownFolderPath.

Fungsi ini membuat profil untuk pengguna saat ini. Untuk membuat profil atas nama pengguna lain, Anda harus meniru pengguna tersebut. Untuk membuat profil untuk beberapa pengguna aplikasi yang sama, Anda harus memanggil CreateAppContainerProfile untuk setiap pengguna.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	userenv.h
Pustaka	Userenv.lib
DLL	Userenv.dll

Lihat juga

DeleteAppContainerProfile

Bagikan melalui