Fungsi InitializeSid (securitybaseapi.h)

Artikel
03/04/2024

Fungsi InitializeSid menginisialisasi pengidentifikasi keamanan (SID).

Sintaks

BOOL InitializeSid(
  [out] PSID                      Sid,
  [in]  PSID_IDENTIFIER_AUTHORITY pIdentifierAuthority,
  [in]  BYTE                      nSubAuthorityCount
);

Parameter

[out] Sid

Penunjuk ke struktur SID yang akan diinisialisasi.

[in] pIdentifierAuthority

Penunjuk ke struktur SID_IDENTIFIER_AUTHORITY untuk diatur dalam struktur SID .

[in] nSubAuthorityCount

Menentukan jumlah subautoritas yang akan diatur dalam SID. Nilai subautoritas harus diatur secara terpisah, seperti yang dijelaskan di bagian Keterangan berikut.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Meskipun fungsi InitializeSid menetapkan jumlah subautoritas untuk SID, fungsi ini tidak mengatur nilai subautoritas. Ini harus dilakukan secara terpisah, menggunakan fungsi seperti GetSidSubAuthority.

Aplikasi dapat menggunakan fungsi AllocateAndInitializeSid untuk menginisialisasi SID dan mengatur nilai subautoritasnya.

Fungsi ini menggunakan nilai RID 32-bit. Untuk aplikasi yang memerlukan nilai RID yang lebih besar, gunakan CreateWellKnownSid.

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