estructura TRUSTEE_A (accctrl.h)

Artículo
11/20/2024

La estructura de TRUSTEE identifica la cuenta de usuario, la cuenta de grupo o sesión de inicio de sesión a la que se aplica un entrada de control de acceso (ACE). La estructura puede usar un nombre o un identificador de seguridad (SID) para identificar al administrador de confianza.

Funciones de control de acceso, como SetEntriesInAcl y GetExplicitEntriesFromAcl, use esta estructura para identificar la cuenta de inicio de sesión asociada con el control de acceso o la información de control de auditoría en una estructura de EXPLICIT_ACCESS.

Sintaxis

typedef struct _TRUSTEE_A {
  struct _TRUSTEE_A          *pMultipleTrustee;
  MULTIPLE_TRUSTEE_OPERATION MultipleTrusteeOperation;
  TRUSTEE_FORM               TrusteeForm;
  TRUSTEE_TYPE               TrusteeType;
  union {
    LPSTR              ptstrName;
    SID                *pSid;
    OBJECTS_AND_SID    *pObjectsAndSid;
    OBJECTS_AND_NAME_A *pObjectsAndName;
  };
  LPCH                       ptstrName;
} TRUSTEE_A, *PTRUSTEE_A, TRUSTEEA, *PTRUSTEEA;

Miembros

pMultipleTrustee

Puntero a una estructura de TRUSTEE que identifica una cuenta de servidor que puede suplantar al usuario identificado por el miembro ptstrName. Este miembro no se admite actualmente y debe ser NULL.

MultipleTrusteeOperation

Valor del tipo de enumeración MULTIPLE_TRUSTEE_OPERATION. Actualmente, este miembro debe ser NO_MULTIPLE_TRUSTEE.

TrusteeForm

Valor del tipo de enumeración TRUSTEE_FORM que indica el tipo de datos al que apunta el miembro ptstrName.

TrusteeType

Valor del tipo de enumeración TRUSTEE_TYPE que indica si el administrador de confianza es una cuenta de usuario, una cuenta de grupo o un tipo de cuenta desconocido.

ptstrName

Puntero a un búfer que identifica al administrador y, opcionalmente, contiene información sobre las ACE específicas del objeto. El tipo de datos depende del valor del miembro TrusteeForm.

Este miembro puede ser uno de los siguientes valores.

Valor	Significado
TRUSTEE_IS_NAME	Puntero a un cadena terminada en nullque contiene el nombre del administrador de confianza.
TRUSTEE_IS_OBJECTS_AND_NAME	Puntero a una estructura OBJECTS_AND_NAME que contiene el nombre del administrador de confianza y los nombres de los tipos de objeto en una ACE específica del objeto.
TRUSTEE_IS_OBJECTS_AND_SID	Puntero a una estructura OBJECTS_AND_SID que contiene el SID del administrador y los GUID de los tipos de objeto en una ACE específica del objeto.
TRUSTEE_IS_SID	Puntero al SID del administrador.

pSid

pObjectsAndSid

pObjectsAndName

Observaciones

Un nombre de administrador de confianza puede tener cualquiera de los siguientes formatos:

Nombre completo, como "g:\remotedir\abc".
Una cuenta de dominio, como "domain1\xyz".
Uno de los nombres de grupo predefinidos, como "TODOS" o "INVITADO".

Uno de los siguientes nombres especiales.

Nombre	Significado
CREATOR GROUP	El SID de CREATOR_GROUP es un SID que se usa en los ACE que se pueden heredar. Cuando se crea un nuevo objeto, el sistema reemplaza este SID por el SID del grupo principal del usuario que creó el objeto.
CREADOR PROPIETARIO	El SID de CREATOR_OWNER es un SID que se usa en los ACE que se pueden heredar. Cuando se crea un nuevo objeto, el sistema reemplaza este SID por el SID del usuario que creó el objeto.
CURRENT_USER	Propietario del subproceso o proceso que realiza la llamada.

Un SID de administrador puede ser cualquier SID de usuario o grupo. También puede ser cualquiera de los SID universales conocidos. Para obtener más información, consulte identificadores de seguridad.

Nota

El encabezado accctrl.h define TRUSTEE_ como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
encabezado de	accctrl.h