Bagikan melalui


Fungsi GetSidSubAuthorityCount (securitybaseapi.h)

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

Lihat juga

Gambaran Umum Access Control

Fungsi Access Control Dasar

CreateWellknownSid

GetLengthSid

GetSidIdentifierAuthority

GetSidLengthRequired

GetSidSubAuthority

IsValidSid

SID