Fungsi AllocateAndInitializeSid (securitybaseapi.h)

Artikel
2023-08-25

Fungsi AllocateAndInitializeSid mengalokasikan dan menginisialisasi pengidentifikasi keamanan (SID) dengan hingga delapan subautoritas.

Sintaks

BOOL AllocateAndInitializeSid(
  [in]  PSID_IDENTIFIER_AUTHORITY pIdentifierAuthority,
  [in]  BYTE                      nSubAuthorityCount,
  [in]  DWORD                     nSubAuthority0,
  [in]  DWORD                     nSubAuthority1,
  [in]  DWORD                     nSubAuthority2,
  [in]  DWORD                     nSubAuthority3,
  [in]  DWORD                     nSubAuthority4,
  [in]  DWORD                     nSubAuthority5,
  [in]  DWORD                     nSubAuthority6,
  [in]  DWORD                     nSubAuthority7,
  [out] PSID                      *pSid
);

Parameter

[in] pIdentifierAuthority

Penunjuk ke struktur SID_IDENTIFIER_AUTHORITY . Struktur ini memberikan nilai otoritas pengidentifikasi tingkat atas untuk diatur dalam SID.

[in] nSubAuthorityCount

Menentukan jumlah subautoritas yang akan ditempatkan di SID. Parameter ini juga mengidentifikasi berapa banyak parameter subautoritas yang memiliki nilai yang bermakna. Parameter ini harus berisi nilai dari 1 hingga 8.

Misalnya, nilai 3 menunjukkan bahwa nilai subautoritas yang ditentukan oleh parameter dwSubAuthority0, dwSubAuthority1, dan dwSubAuthority2 memiliki nilai yang bermakna dan untuk mengabaikan sisanya.

[in] nSubAuthority0