Fungsi GetAppContainerFolderPath (userenv.h)

Artikel
03/03/2024

Mendapatkan jalur folder data aplikasi lokal untuk kontainer aplikasi yang ditentukan.

Sintaks

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

Parameter

[in] pszAppContainerSid

Penunjuk ke SID kontainer aplikasi.

[out] ppszPath

Alamat penunjuk ke string yang, ketika fungsi ini berhasil dikembalikan, menerima jalur folder lokal. Pemanggil bertanggung jawab untuk membebaskan string ini ketika tidak lagi diperlukan dengan memanggil fungsi CoTaskMemFree .

Mengembalikan nilai

Fungsi ini mengembalikan kode HRESULT , termasuk tetapi tidak terbatas pada yang berikut:

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil diselesaikan.
E_INVALIDARG	Parameter pszAppContainerSid atau ppszPath adalah NULL.

Keterangan

Jalur yang diambil melalui fungsi ini adalah jalur yang sama dengan yang akan Anda dapatkan dengan memanggil fungsi SHGetKnownFolderPath dengan FOLDERID_LocalAppData.

Jika token utas diatur, fungsi ini menggunakan kontainer aplikasi untuk pengguna saat ini. Jika tidak ada token utas yang diatur, fungsi ini menggunakan kontainer aplikasi yang terkait dengan identitas proses.

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

GetAppContainerRegistryLocation

Bagikan melalui