Fungsi GetSidIdentifierAuthority (securitybaseapi.h)

Artikel
03/01/2024

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