Partager via


BuildTrusteeWithObjectsAndNameW, fonction (aclapi.h)

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

Voir aussi

de contrôle d’accès

fonctions de contrôle d’accès de base

BuildTrusteeWithName

BuildTrusteeWithObjectsAndSid

BuildTrusteeWithSid

OBJECTS_AND_NAME

acEs spécifiques à l’objet

SE_OBJECT_TYPE

FIDUCIAIRE