Fonction DeriveCapabilitySidsFromName (securitybaseapi.h)

Article
03/01/2024

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

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	securitybaseapi.h (inclure Windows.h)
Bibliothèque	Advapi32.lib
DLL	Kernel32.dll

Partager via