Partager via


CopySid, fonction (securitybaseapi.h)

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

Voir aussi

Vue d’ensemble du contrôle d’accès

AllocateAndInitializeSid

Fonctions Access Control de base

EqualSid

GetLengthSid

GetSidIdentifierAuthority

GetSidLengthRequired

GetSidSubAuthority

GetSidSubAuthorityCount

InitializeSid

IsValidSid

SID