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