Fungsi GetSidSubAuthorityCount (securitybaseapi.h)

Artikel
03/01/2024

Fungsi GetSidSubAuthorityCount mengembalikan penunjuk ke anggota dalam struktur pengidentifikasi keamanan (SID) yang berisi jumlah subautoritas.

Sintaks

PUCHAR GetSidSubAuthorityCount(
  [in] PSID pSid
);

Parameter

[in] pSid

Penunjuk ke struktur SID tempat penunjuk ke jumlah subautoritas 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 jumlah subautoritas untuk struktur SID yang ditentukan.

Jika fungsi gagal, nilai yang dikembalikan tidak terdefinisi. Fungsi gagal jika struktur SID yang ditentukan tidak valid. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Struktur SID yang ditentukan dalam pSid menggunakan nilai 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