Fungsi SetUserObjectSecurity (winuser.h)

Artikel
08/28/2023

Fungsi SetUserObjectSecurity mengatur keamanan objek pengguna. Ini bisa berupa, misalnya, jendela atau percakapan DDE.

Sintaks

BOOL SetUserObjectSecurity(
  [in] HANDLE                hObj,
  [in] PSECURITY_INFORMATION pSIRequested,
  [in] PSECURITY_DESCRIPTOR  pSID
);

Parameter

[in] hObj

Handel ke objek pengguna tempat informasi keamanan diatur.

[in] pSIRequested

Penunjuk ke nilai yang menunjukkan komponen deskriptor keamanan yang akan diatur. Parameter ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Makna
DACL_SECURITY_INFORMATION	Mengatur daftar kontrol akses diskresi (DACL) objek. Handel yang ditentukan oleh hObj harus memiliki akses WRITE_DAC, atau proses panggilan harus menjadi pemilik objek.
GROUP_SECURITY_INFORMATION	Mengatur pengidentifikasi keamanan grup utama (SID) objek.
OWNER_SECURITY_INFORMATION	Mengatur SID pemilik objek. Handel yang ditentukan oleh hObj harus memiliki akses WRITE_OWNER, atau proses panggilan harus menjadi pemilik objek atau mengaktifkan hak istimewa SE_TAKE_OWNERSHIP_NAME.
SACL_SECURITY_INFORMATION	Mengatur daftar kontrol akses sistem (SACL) objek. Handel yang ditentukan oleh hObj harus memiliki akses ACCESS_SYSTEM_SECURITY. Untuk mendapatkan akses ACCESS_SYSTEM_SECURITY Aktifkan hak istimewa SE_SECURITY_NAME dalam token akses penelepon saat ini. Buka handel untuk akses ACCESS_SYSTEM_SECURITY. Nonaktifkan hak istimewa.

[in] pSID

Penunjuk ke struktur SECURITY_DESCRIPTOR yang berisi informasi keamanan baru.

Buffer ini harus diselaraskan pada batas 4-byte.

Nilai kembali

Jika fungsi berhasil, fungsi mengembalikan bukan nol.

Jika fungsi gagal, fungsi akan mengembalikan nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi SetUserObjectSecurity menerapkan perubahan yang ditentukan dalam deskriptor keamanan ke deskriptor keamanan yang ditetapkan ke objek pengguna. Deskriptor keamanan objek harus dalam bentuk relatif mandiri . Jika perlu, fungsi ini mengalokasikan memori tambahan untuk meningkatkan ukuran deskriptor keamanan.

Contoh

Untuk contoh yang menggunakan fungsi ini, lihat Memulai Proses Klien Interaktif.

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	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll