Fonction DeriveCapabilitySidsFromName (securitybaseapi.h)

Cette fonction construit deux tableaux de SID à partir d’un nom de fonctionnalité. Un des tableaux est un groupe de tableaux de SID avec NT Authority et l’autre est un tableau de SID de capacité avec AppAuthority.

Syntaxe

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

Paramètres

[in] CapName

Nom de la fonctionnalité sous forme de chaîne.

[out] CapabilityGroupSids

GroupSids avec NTAuthority.

[out] CapabilityGroupSidCount

Nombre de GroupSids dans le tableau.

[out] CapabilitySids

CapabilitySids avec AppAuthority.

[out] CapabilitySidCount

Nombre de CapabilitySid avec AppAuthority.

Valeur renvoyée

Si la fonction réussit, elle retourne TRUE.

Si la fonction échoue, elle retourne FALSE. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

L’appelant est censé libérer les SID individuels retournés dans chaque tableau en appelant LocalFree, ainsi que la mémoire allouée pour le tableau lui-même.

Le SID calculé pour la fonctionnalité d’application des fonctionnalités héritées (publiées avant Win10) sera identique aux SID publiés, mais le SID pour le SID de la fonctionnalité de groupe de services sera basé sur le hachage.

Exigences