Fungsi DeleteAppContainerProfile (userenv.h)

Menghapus profil per pengguna per aplikasi yang ditentukan.

Catatan Menghapus profil yang tidak ada akan mengembalikan keberhasilan.

 

Sintaks

USERENVAPI HRESULT DeleteAppContainerProfile(
  [in] PCWSTR pszAppContainerName
);

Parameter

[in] pszAppContainerName

Nama yang diberikan ke profil dalam panggilan ke fungsi CreateAppContainerProfile . Panjang string ini paling banyak 64 karakter, dan cocok dengan pola yang dijelaskan oleh ekspresi reguler "[-_. A-Za-z0-9]+".

Nilai kembali

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

Menampilkan kode	Deskripsi
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Jika metode dipanggil dari dalam kontainer aplikasi.
S_OK	Profil berhasil dihapus.
E_INVALIDARG	Jika nama kontainer adalah NULL, atau jika melebihi batas yang ditentukan untuk panjangnya.

Keterangan

Untuk memastikan hasil terbaik, tutup semua handel file di lokasi penyimpanan profil sebelum memanggil fungsi DeleteAppContainerProfile . Jika tidak, fungsi ini mungkin tidak dapat sepenuhnya menghapus lokasi penyimpanan untuk profil.

Fungsi ini menghapus profil untuk pengguna saat ini. Untuk menghapus profil untuk pengguna lain, Anda harus meniru pengguna tersebut.

Jika fungsi gagal, status profil tidak ditentukan, dan Anda harus memanggil DeleteAppContainerProfile lagi untuk menyelesaikan operasi.

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

CreateAppContainerProfile