BuildTrusteeWithObjectsAndNameA, fonction (aclapi.h)
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 |