Funzione DeriveCapabilitySidsFromName (securitybaseapi.h)

Questa funzione costruisce due matrici di SID fuori da un nome di funzionalità. Uno è un SID di matrice con NT Authority e l'altro è una matrice di SID di funzionalità con AppAuthority.

Sintassi

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

Parametri

[in] CapName

Nome della funzionalità nel formato stringa.

[out] CapabilityGroupSids

GroupSids con NTAuthority.

[out] CapabilityGroupSidCount

Numero di GroupSids nella matrice.

[out] CapabilitySids

FunzionalitàSids con AppAuthority.

[out] CapabilitySidCount

Conteggio di CapabilitySid con AppAuthority.

Valore restituito

Se la funzione ha esito positivo, restituisce TRUE.

Se la funzione ha esito negativo, restituisce FALSE. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Il chiamante deve liberare i singoli SID restituiti in ogni matrice chiamando LocalFree, nonché la memoria allocata per la matrice stessa.

Il SID calcolato per la funzionalità dell'applicazione delle funzionalità legacy (pubblicate prima di Win10) sarà uguale ai SID pubblicati, ma il SID per la funzionalità del gruppo di servizi sarà basato sull'hash.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [app desktop | App UWP]
Server minimo supportato	Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	securitybaseapi.h (include Windows.h)
Libreria	Advapi32.lib
DLL	Kernel32.dll