CopySid, fonction (securitybaseapi.h)

Article
03/01/2024

La fonction CopySid copie un identificateur de sécurité (SID) dans une mémoire tampon.

Syntaxe

BOOL CopySid(
  [in]  DWORD nDestinationSidLength,
  [out] PSID  pDestinationSid,
  [in]  PSID  pSourceSid
);

Paramètres

[in] nDestinationSidLength

Spécifie la longueur, en octets, de la mémoire tampon recevant la copie du SID.

[out] pDestinationSid

Pointeur vers une mémoire tampon qui reçoit une copie de la structure SID source.

[in] pSourceSid

Pointeur vers une structure SID que la fonction copie dans la mémoire tampon pointée par le paramètre pDestinationSid .

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

Une application peut utiliser la fonction CopySid pour effectuer une copie d’un SID dans un jeton d’accès (par exemple, dans une structure TOKEN_GROUPS ) à utiliser dans une entrée de contrôle d’accès (ACE).

Exemples

Pour obtenir un exemple qui utilise cette fonction, consultez Obtention du SID d’ouverture de session.

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