Fonction AllocateAndInitializeSid (securitybaseapi.h)
La fonction AllocateAndInitializeSid alloue et initialise un identificateur de sécurité (SID) avec jusqu’à huit sous-entités.
Syntaxe
BOOL AllocateAndInitializeSid(
[in] PSID_IDENTIFIER_AUTHORITY pIdentifierAuthority,
[in] BYTE nSubAuthorityCount,
[in] DWORD nSubAuthority0,
[in] DWORD nSubAuthority1,
[in] DWORD nSubAuthority2,
[in] DWORD nSubAuthority3,
[in] DWORD nSubAuthority4,
[in] DWORD nSubAuthority5,
[in] DWORD nSubAuthority6,
[in] DWORD nSubAuthority7,
[out] PSID *pSid
);
Paramètres
[in] pIdentifierAuthority
Pointeur vers une structure SID_IDENTIFIER_AUTHORITY . Cette structure fournit la valeur d’autorité d’identificateur de niveau supérieur à définir dans le SID.
[in] nSubAuthorityCount
Spécifie le nombre de sous-autorisation à placer dans le SID. Ce paramètre identifie également le nombre de paramètres de sous-autorisation qui ont des valeurs significatives. Ce paramètre doit contenir une valeur comprise entre 1 et 8.
Par exemple, la valeur 3 indique que les valeurs de sous-autorisation spécifiées par les paramètres dwSubAuthority0, dwSubAuthority1 et dwSubAuthority2 ont des valeurs significatives et ignorent le reste.
[in] nSubAuthority0
Valeur de sous-autorisation à placer dans le SID.
[in] nSubAuthority1
Valeur de sous-autorisation à placer dans le SID.
[in] nSubAuthority2
Valeur de sous-autorisation à placer dans le SID.
[in] nSubAuthority3
Valeur de sous-autorisation à placer dans le SID.
[in] nSubAuthority4
Valeur de sous-autorisation à placer dans le SID.
[in] nSubAuthority5
Valeur de sous-autorisation à placer dans le SID.
[in] nSubAuthority6
Valeur de sous-autorisation à placer dans le SID.
[in] nSubAuthority7
Valeur de sous-autorisation à placer dans le SID.
[out] pSid
Pointeur vers une variable qui reçoit le pointeur vers la structure SID allouée et initialisée.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Un SID alloué avec la fonction AllocateAndInitializeSid doit être libéré à l’aide de la fonction FreeSid .
Cette fonction crée un SID avec une valeur RID 32 bits. Pour les applications qui nécessitent des valeurs RID plus longues, utilisez CreateWellKnownSid.
Exemples
Pour obtenir un exemple qui utilise cette fonction, consultez Création d’un descripteur de sécurité pour un nouvel objet ou Prise de propriété de l’objet.
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 | Advapi32.dll |