Fonction CreateWellKnownSid (securitybaseapi.h)

  • Article

La fonction CreateWellKnownSid crée un SID pour les alias prédéfinis.

Syntaxe

BOOL CreateWellKnownSid(
  [in]            WELL_KNOWN_SID_TYPE WellKnownSidType,
  [in, optional]  PSID                DomainSid,
  [out, optional] PSID                pSid,
  [in, out]       DWORD               *cbSid
);

Paramètres

[in] WellKnownSidType

Membre de l’énumération WELL_KNOWN_SID_TYPE qui spécifie ce que le SID identifiera.

[in, optional] DomainSid

Pointeur vers un SID qui identifie le domaine à utiliser lors de la création du SID. Passez la valeur NULL pour utiliser l’ordinateur local.

[out, optional] pSid

Pointeur vers la mémoire où CreateWellKnownSid stocke le nouveau SID.

[in, out] cbSid

Pointeur vers un DWORD qui contient le nombre d’octets disponibles dans pSid. La fonction CreateWellKnownSid stocke le nombre d’octets réellement utilisés à cet emplacement.

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’erreur étendues, appelez GetLastError.

Spécifications

   
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

EqualDomainSid

GetWindowsAccountDomainSid

IsWellKnownSid

WELL_KNOWN_SID_TYPE