Fonction BuildTrusteeWithObjectsAndNameW (aclapi.h)

Article
08/22/2023

La fonction BuildTrusteeWithObjectsAndName initialise une structure TRUSTEE avec les informations d’entrée de contrôle d’accès spécifiques à l’objet (ACE) et initialise les autres membres de la structure en valeurs par défaut. L’appelant spécifie également le nom du fiduciaire.

Syntaxe

void BuildTrusteeWithObjectsAndNameW(
  [in, out]      PTRUSTEE_W          pTrustee,
  [in, optional] POBJECTS_AND_NAME_W pObjName,
  [in, optional] SE_OBJECT_TYPE      ObjectType,
  [in, optional] LPWSTR              ObjectTypeName,
  [in, optional] LPWSTR              InheritedObjectTypeName,
  [in, optional] LPWSTR              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 si un pointeur n’est pas 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 correspondant 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 correspondant 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 pour les structures TRUSTEE et OBJECTS_AND_NAME .

Pour plus d’informations sur les AE spécifiques à un objet, consultez Les AE spécifiques à l’objet.

Notes

L’en-tête aclapi.h définit BuildTrusteeWithObjectsAndName comme un 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. Le mélange 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