BuildTrusteeWithObjectsAndNameA, fonction (aclapi.h)

Article
11/20/2024

La fonction BuildTrusteeWithObjectsAndName initialise une structure TRUSTEE avec l’entrée de contrôle d’accès spécifique à l’objet (ACE) et initialise les membres restants de la structure en 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

Aucun

Remarques

Cette fonction n’alloue pas de mémoire pour les structures de trust et de OBJECTS_AND_NAME.

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

Note

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. 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	aclapi.h
bibliothèque	Advapi32.lib
DLL	Advapi32.dll