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.

Syntax

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

Parameters

[in] CapName

Nama kemampuan 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.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan TRUE.

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

Komentar

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]
Platform Target	Windows
Header	securitybaseapi.h (termasuk Windows.h)
Library	OneCoreUAP.lib
DLL	KernelBase.dll