Fonction RtlAbsoluteToSelfRelativeSD (ntifs.h)

Article
02/26/2024

La routine RtlAbsoluteToSelfRelativeSD crée un descripteur de sécurité au format auto-relatif en utilisant un descripteur de sécurité au format absolu comme modèle.

Syntaxe

NTSYSAPI NTSTATUS RtlAbsoluteToSelfRelativeSD(
  [in]      PSECURITY_DESCRIPTOR AbsoluteSecurityDescriptor,
  [out]     PSECURITY_DESCRIPTOR SelfRelativeSecurityDescriptor,
  [in, out] PULONG               BufferLength
);

Paramètres

[in] AbsoluteSecurityDescriptor

Pointeur vers une mémoire tampon allouée à l’appelant qui contient une structure SECURITY_DESCRIPTOR au format absolu. RtlAbsoluteToSelfRelativeSD crée une version de ce descripteur de sécurité au format auto-relatif sans modifier l’original.

[out] SelfRelativeSecurityDescriptor

Pointeur vers une mémoire tampon allouée par l’appelant qui reçoit un descripteur de sécurité au format auto-relatif.

[in, out] BufferLength

Pointeur vers une variable allouée par l’appelant qui spécifie la taille, en octets, de la mémoire tampon vers laquelle pointe le paramètre SelfRelativeSecurityDescriptor . Si la mémoire tampon n’est pas assez grande pour contenir le descripteur de sécurité, RtlAbsoluteToSelfRelativeSD retourne STATUS_BUFFER_TOO_SMALL et définit cette variable sur la taille minimale requise.

Valeur retournée

RtlAbsoluteToSelfRelativeSD retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, telle que l’une des valeurs suivantes :

Code de retour	Description
STATUS_BAD_DESCRIPTOR_FORMAT	La mémoire tampon pointée par le paramètre AbsoluteSecurityDescriptor ne contenait pas de structure SECURITY_DESCRIPTOR au format absolu. STATUS_BAD_DESCRIPTOR_FORMAT est un code d’erreur.
STATUS_BUFFER_TOO_SMALL	La mémoire tampon pointée par le paramètre SelfRelativeSecurityDescriptor était trop petite pour contenir le descripteur de sécurité dans un format auto-relatif. STATUS_BUFFER_TOO_SMALL est un code d’erreur.

Remarques

Un descripteur de sécurité au format absolu contient des pointeurs vers les informations qu’il contient, au lieu de contenir les informations elles-mêmes. Un descripteur de sécurité au format auto-relatif contient les informations dans un bloc de mémoire contigu. Dans un descripteur de sécurité auto-relatif, une structure SECURITY_DESCRIPTOR démarre toujours les informations, mais les autres composants du descripteur de sécurité peuvent suivre la structure SECURITY_DESCRIPTOR dans n’importe quel ordre. Au lieu d’utiliser des adresses mémoire, les composants du descripteur de sécurité sont identifiés par des décalages à partir du début du descripteur de sécurité. Ce format est utile lorsqu’un descripteur de sécurité doit être stocké sur un disque ou transmis au moyen d’un protocole de communication.

Pour créer un descripteur de sécurité au format absolu en utilisant un descripteur de sécurité au format auto-relatif comme modèle, utilisez RtlSelfRelativeToAbsoluteSD.

Pour plus d’informations sur la sécurité et le contrôle d’accès, consultez la documentation Microsoft Windows SDK.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Server 2003 SP1
Plateforme cible	Universal
En-tête	ntifs.h (include Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe (mode noyau) ; Ntdll.dll (mode utilisateur)
IRQL	<= APC_LEVEL