Fungsi GetUserObjectSecurity (winuser.h)

Artikel
03/13/2024

Fungsi GetUserObjectSecurity mengambil informasi keamanan untuk objek pengguna yang ditentukan.

Sintaks

BOOL GetUserObjectSecurity(
  [in]                HANDLE                hObj,
  [in]                PSECURITY_INFORMATION pSIRequested,
  [in, out, optional] PSECURITY_DESCRIPTOR  pSID,
  [in]                DWORD                 nLength,
  [out]               LPDWORD               lpnLengthNeeded
);

Parameter

[in] hObj

Handel ke objek pengguna untuk mengembalikan informasi keamanan.

[in] pSIRequested

Penunjuk ke nilai SECURITY_INFORMATION yang menentukan informasi keamanan yang diminta.

[in, out, optional] pSID

Penunjuk ke struktur SECURITY_DESCRIPTOR dalam format relatif mandiri yang berisi informasi yang diminta saat fungsi kembali. Buffer ini harus diselaraskan pada batas 4-byte.

[in] nLength

Panjangnya, dalam byte, dari buffer yang diacu oleh parameter pSD .

[out] lpnLengthNeeded

Penunjuk ke variabel untuk menerima jumlah byte yang diperlukan untuk menyimpan deskriptor keamanan lengkap. Jika nilai variabel ini lebih besar dari nilai parameter nLength saat fungsi kembali, fungsi mengembalikan FALSE dan tidak ada deskriptor keamanan yang disalin ke buffer. Jika tidak, seluruh deskriptor keamanan disalin.

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

Untuk membaca pemilik, grup, atau daftar kontrol akses diskresi (DACL) dari deskriptor keamanan objek pengguna, proses panggilan harus diberikan READ_CONTROL akses saat handel dibuka.

Untuk membaca daftar kontrol akses sistem (SACL) dari pendeskripsi keamanan, proses panggilan harus diberikan ACCESS_SYSTEM_SECURITY akses saat handel dibuka. Cara yang benar untuk mendapatkan akses ini adalah dengan mengaktifkan hak istimewa SE_SECURITY_NAME dalam token pemanggil saat ini, buka handel untuk akses ACCESS_SYSTEM_SECURITY, lalu nonaktifkan hak istimewa.

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