SecLookupWellKnownSid, fonction (ntifs.h)

SecLookupWellKnownSid accepte un type d’identificateur de sécurité (SID) connu comme entrée et récupère l’identificateur de sécurité local (SID) pour ce SID bien connu.

Syntaxe

KSECDDDECLSPEC NTSTATUS SEC_ENTRY SecLookupWellKnownSid(
  [in]               WELL_KNOWN_SID_TYPE SidType,
  [out]              PSID                Sid,
  [in]               ULONG               SidBufferSize,
  [in_out, optional] PULONG              SidSize
);

Paramètres

[in] SidType

Type énuméré qui indique le type d’identificateur de sécurité (SID) retourné par la fonction. Ce paramètre peut être l’une des énumérations suivantes pour WELL_KNOWN_SID_TYPE.

[out] Sid

Pointeur vers une mémoire tampon qui reçoit la structure SID qui correspond au paramètre SidType . Si ce paramètre a la valeur NULL, SidBufferSize est égal à zéro.

[in] SidBufferSize

Variable qui spécifie la taille de la mémoire tampon Sid en octets.

[in_out, optional] SidSize

Pointeur facultatif vers une variable qui spécifie la taille de la mémoire tampon Sid . Si la fonction échoue parce que la mémoire tampon est trop petite ou si SidBufferSize est égal à zéro, cette variable reçoit la taille de mémoire tampon requise. En cas de réussite, cette variable contient la taille du Sid retourné.

Valeur retournée

SecLookupWellKnownSid retourne STATUS_SUCCESS en cas de réussite ou l’un des codes d’erreur suivants en cas d’échec :

Remarques

SecLookupWellKnownSid tente de trouver un SID connu à l’aide d’un paramètre SidType . En plus de rechercher des SID connus sur l’ordinateur local, SecLookupWellKnownSid peut rechercher des SID connus sur le domaine local. SecLookupWellKnownSidvérifie d’abord une liste de SID locaux bien connus. Si le SidType ne correspond pas à un SID local bien connu, la fonction recherche les SID connus sur le domaine principal.

Si la fonction ne trouve pas le SID connu pour le SidType spécifié, SecLookupWellKnownSid échoue. Cela peut se produire si un délai d’attente réseau empêche la fonction de rechercher le SID sur le domaine principal. Cela se produit également pour un SidType qui n’a pas de SID connu correspondant.

SecLookupWellKnownSid équivaut à la fonction Win32 CreateWellKnownSid . Pour les applications en mode utilisateur, l’énumération WELL_KNOWN_SID_TYPE est définie dans winbase.h.

SecLookupWellKnownSid est exporté par le pilote ksecdd, qui implémente cette fonction à l’aide des services d’assistance en mode utilisateur. Par conséquent, l’utilisation de cette fonction dans les systèmes de fichiers doit respecter les règles habituelles de communication avec les services en mode utilisateur. SecLookupWellKnownSid ne peut pas être utilisé lors de la pagination des E/S du fichier.

Configuration requise

Voir aussi

SID

SecLookupAccountName

SecLookupAccountSid