ISecurityInformation::SetSecurity method (aclui.h)

Artikel
02/26/2024

Metode SetSecurity menyediakan deskriptor keamanan yang berisi informasi keamanan yang ingin diterapkan pengguna ke objek yang dapat diamankan. Editor kontrol akses memanggil metode ini ketika pengguna mengklik Oke atau Terapkan.

Sintaks

HRESULT SetSecurity(
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

Parameter

[in] SecurityInformation

Sekumpulan bendera bit SECURITY_INFORMATION yang menunjukkan bagian deskriptor keamanan untuk diatur. Parameter ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Makna
OWNER_SECURITY_INFORMATION	Deskriptor keamanan berisi SID pemilik objek.
GROUP_SECURITY_INFORMATION	Deskriptor keamanan berisi SID grup utama objek.
DACL_SECURITY_INFORMATION	Deskriptor keamanan berisi DACL objek.
SACL_SECURITY_INFORMATION	Deskriptor keamanan berisi SACL objek.

[in] pSecurityDescriptor

Penunjuk ke deskriptor keamanan yang berisi informasi keamanan baru. Jangan berasumsi deskriptor keamanan dalam bentuk relatif mandiri ; itu bisa absolut atau relatif sendiri.

Menampilkan nilai

Mengembalikan S_OK jika berhasil.

Mengembalikan kode kesalahan bukan nol jika terjadi kesalahan.

Keterangan

Untuk membangun deskriptor keamanan lengkap untuk objek, aplikasi harus menggabungkan bagian deskriptor keamanan baru, seperti yang didefinisikan oleh parameter SecurityInformation , ke dalam deskriptor keamanan objek yang ada.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	aclui.h

Lihat juga

Editor Access Control

Fungsi Editor Access Control

ISecurityInformation

SECURITY_INFORMATION

Bagikan melalui