Bagikan melalui


Fungsi SetUserObjectSecurity (winuser.h)

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

  1. Aktifkan hak istimewa SE_SECURITY_NAME dalam token akses penelepon saat ini.
  2. Buka handel untuk akses ACCESS_SYSTEM_SECURITY.
  3. 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

Lihat juga

GetUserObjectSecurity

Access Control tingkat rendah

Fungsi Access Control tingkat rendah

SECURITY_DESCRIPTOR

SECURITY_INFORMATION

SetFileSecurity

SetKernelObjectSecurity

SetPrivateObjectSecurity