Fungsi GetSidSubAuthority (securitybaseapi.h)

Artikel
03/15/2023

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