Fungsi GetSidIdentifierAuthority (securitybaseapi.h)
Fungsi GetSidIdentifierAuthority mengembalikan penunjuk ke struktur SID_IDENTIFIER_AUTHORITY dalam pengidentifikasi keamanan (SID) tertentu.
Sintaks
PSID_IDENTIFIER_AUTHORITY GetSidIdentifierAuthority(
[in] PSID pSid
);
Parameter
[in] pSid
Penunjuk ke struktur SID tempat penunjuk ke struktur SID_IDENTIFIER_AUTHORITY dikembalikan.
Fungsi ini tidak menangani struktur SID yang tidak valid. Panggil fungsi IsValidSid untuk memverifikasi bahwa struktur SID valid sebelum Anda memanggil fungsi ini.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan adalah penunjuk ke struktur SID_IDENTIFIER_AUTHORITY untuk struktur SID yang ditentukan.
Jika fungsi gagal, nilai yang dikembalikan tidak terdefinisi. Fungsi gagal jika struktur SID yang diacu oleh parameter pSid tidak valid. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Fungsi ini menggunakan nilai RID 32-bit. Untuk aplikasi yang memerlukan nilai RID yang lebih besar, 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 |