Fungsi DeriveCapabilitySidsFromName (securitybaseapi.h)

Artikel
03/01/2024

Fungsi ini membangun dua array SID dari nama kemampuan. Salah satunya adalah SID grup array dengan Otoritas NT, dan yang lainnya adalah array SID kemampuan dengan AppAuthority.

Sintaks

BOOL DeriveCapabilitySidsFromName(
  [in]  LPCWSTR CapName,
  [out] PSID    **CapabilityGroupSids,
  [out] DWORD   *CapabilityGroupSidCount,
  [out] PSID    **CapabilitySids,
  [out] DWORD   *CapabilitySidCount
);

Parameter

[in] CapName

Nama kapabilitas dalam bentuk string.

[out] CapabilityGroupSids

GroupSids dengan NTAuthority.

[out] CapabilityGroupSidCount

Jumlah GroupSids dalam array.

[out] CapabilitySids

CapabilitySids dengan AppAuthority.

[out] CapabilitySidCount

Jumlah CapabilitySid dengan AppAuthority.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan TRUE.

Jika fungsi gagal, fungsi akan mengembalikan FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Pemanggil diharapkan untuk membebaskan SID individu yang dikembalikan di setiap array dengan memanggil LocalFree, serta memori yang dialokasikan untuk array itu sendiri.

SID yang dihitung untuk kemampuan aplikasi kemampuan warisan (diterbitkan sebelum Win10) akan sama dengan SID yang diterbitkan tetapi SID untuk SID kemampuan grup layanan akan berbasis hash.

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	Kernel32.dll

Bagikan melalui