Fungsi DeriveCapabilitySidsFromName (securitybaseapi.h)
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 |