Fonction DeriveCapabilitySidsFromName (securitybaseapi.h)

Cette fonction construit deux tableaux de SID à partir d’un nom de fonctionnalité. L’un est un SID de groupe de tableaux avec l’autorité NT, et l’autre est un tableau de SIDs 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 retournée

Si la fonction réussit, elle retourne TRUE.

Si la fonction échoue, elle retourne FALSE. Pour obtenir des informations détaillées sur l’erreur, 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 le même que les SID publiés, mais le SID pour le SID de capacité de groupe de services sera basé sur le hachage.

Configuration requise