Fungsi SetSecurityDescriptorOwner (securitybaseapi.h)

Artikel
03/15/2023

Fungsi SetSecurityDescriptorOwner mengatur informasi pemilik deskriptor keamanan berformat absolut. Ini menggantikan informasi pemilik apa pun yang sudah ada di deskriptor keamanan.

Sintaks

BOOL SetSecurityDescriptorOwner(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, optional] PSID                 pOwner,
  [in]           BOOL                 bOwnerDefaulted
);

Parameter

[in, out] pSecurityDescriptor

Penunjuk ke struktur SECURITY_DESCRIPTOR yang pemiliknya ditetapkan oleh fungsi ini. Fungsi ini menggantikan pemilik yang ada dengan pemilik baru.

[in, optional] pOwner

Penunjuk ke struktur SID untuk pemilik utama baru deskriptor keamanan. Struktur SID direferensikan oleh, tidak disalin ke dalam, deskriptor keamanan. Jika parameter ini NULL, fungsi akan menghapus informasi pemilik deskriptor keamanan. Ini menandai deskriptor keamanan sebagai tidak memiliki pemilik.

[in] bOwnerDefaulted

Menunjukkan apakah informasi pemilik berasal dari mekanisme default. Jika nilai ini TRUE, nilai tersebut adalah informasi default. Fungsi menyimpan nilai ini sebagai bendera SE_OWNER_DEFAULTED dalam struktur SECURITY_DESCRIPTOR_CONTROL . Jika parameter ini nol, bendera SE_OWNER_DEFAULTED akan dihapus.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Persyaratan


Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	securitybaseapi.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll