Fungsi GetSidSubAuthority (securitybaseapi.h)
Fungsi GetSidSubAuthority mengembalikan penunjuk ke subautoritas tertentu dalam pengidentifikasi keamanan (SID). Nilai subautoritas adalah pengidentifikasi relatif (RID).
Sintaks
PDWORD GetSidSubAuthority(
[in] PSID pSid,
[in] DWORD nSubAuthority
);
Parameter
[in] pSid
Penunjuk ke struktur SID tempat penunjuk ke subautoritas akan dikembalikan.
Fungsi ini tidak menangani struktur SID yang tidak valid. Panggil fungsi IsValidSid untuk memverifikasi bahwa struktur SID valid sebelum Anda memanggil fungsi ini.
[in] nSubAuthority
Menentukan nilai indeks yang mengidentifikasi elemen array subautoritas yang alamatnya akan dikembalikan fungsi. Fungsi ini tidak melakukan pengujian validasi pada nilai ini. Aplikasi dapat memanggil fungsi GetSidSubAuthorityCount untuk menemukan rentang nilai yang dapat diterima.
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah penunjuk ke subautoritas SID yang ditentukan. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Jika fungsi gagal, nilai yang dikembalikan tidak terdefinisi. Fungsi gagal jika struktur SID yang ditentukan tidak valid atau jika nilai indeks yang ditentukan oleh parameter nSubAuthority berada di luar batas.
Keterangan
Struktur SID yang ditentukan dalam pSid menggunakan nilai RID 32-bit. Untuk aplikasi yang memerlukan nilai RID yang lebih panjang, gunakan CreateWellKnownSid dan fungsi terkait.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| 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 |