BuildTrusteeWithObjectsAndNameA, fonction (aclapi.h)

Article
02/23/2024

La fonction BuildTrusteeWithObjectsAndName initialise une structure TRUSTEE avec les informations ACE ( Access Control Entry ) spécifiques à l’objet et initialise les membres restants de la structure sur les valeurs par défaut. L’appelant spécifie également le nom du fiduciaire.

Syntaxe

void BuildTrusteeWithObjectsAndNameA(
  [in, out]      PTRUSTEE_A          pTrustee,
  [in, optional] POBJECTS_AND_NAME_A pObjName,
  [in, optional] SE_OBJECT_TYPE      ObjectType,
  [in, optional] LPSTR               ObjectTypeName,
  [in, optional] LPSTR               InheritedObjectTypeName,
  [in, optional] LPSTR               Name
);

Paramètres

[in, out] pTrustee

Pointeur vers une structure TRUSTEE qui sera initialisée par cette fonction. Si la valeur de ce paramètre est NULL ou un pointeur non valide, les résultats ne sont pas définis.

[in, optional] pObjName

Pointeur vers une structure OBJECTS_AND_NAME qui contient des informations sur le fiduciaire et l’objet sécurisable.

[in, optional] ObjectType

Pointeur vers une énumération SE_OBJECT_TYPE qui contient des informations sur le type d’objet sécurisable.

[in, optional] ObjectTypeName

Pointeur vers une chaîne qui spécifie le nom qui correspond au GUID ObjectType à ajouter à la structure TRUSTEE retournée dans le paramètre pTrustee . Cette fonction détermine le GUID ObjectType qui correspond à ce nom.

[in, optional] InheritedObjectTypeName

Pointeur vers une chaîne qui spécifie le nom qui correspond au GUID InheritedObjectType à ajouter à la structure TRUSTEE retournée dans le paramètre pTrustee . Cette fonction détermine le GUID InheritedObjectType qui correspond à ce nom.

[in, optional] Name

Pointeur vers une chaîne qui spécifie le nom utilisé pour identifier le fiduciaire.

Valeur de retour

None

Remarques

Cette fonction n’alloue pas de mémoire aux structures TRUSTEE et OBJECTS_AND_NAME .

Pour plus d’informations sur les ACL spécifiques aux objets, consultez ACL spécifiques aux objets.

Notes

L’en-tête aclapi.h définit BuildTrusteeWithObjectsAndName comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	aclapi.h
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll