Funzione DeriveCapabilitySidsFromName (securitybaseapi.h)

Questa funzione costruisce due matrici di SID da un nome di funzionalità. Uno è un SID di gruppo di matrici 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
);

Parameters

[in] CapName

Nome della funzionalità in formato stringa.

[out] CapabilityGroupSids

GroupSids con NTAuthority.

[out] CapabilityGroupSidCount

Conteggio di GroupSids nella matrice.

[out] CapabilitySids

CapabilitySids 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni:

Il chiamante dovrebbe 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	Value
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 (includere Windows.h)
Raccolta	OneCoreUAP.lib
DLL	KernelBase.dll