estructura de TRUSTEE_A (accctrl.h)

Artículo
02/23/2024

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

Las funciones de control de acceso, como SetEntriesInAcl y GetExplicitEntriesFromAcl, usan 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 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 TRUSTEE_FORM tipo de enumeración 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 es una cuenta de usuario, una cuenta de grupo o un tipo de cuenta desconocido.

ptstrName

Un puntero a un búfer que identifica el administrador y, opcionalmente, contiene información sobre los ASE específicos 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 una cadena terminada en null que contiene el nombre del administrador de confianza.
TRUSTEE_IS_OBJECTS_AND_NAME	Puntero a una estructura de OBJECTS_AND_NAME que contiene el nombre del administrador y los nombres de los tipos de objeto en una ACE específica del objeto.
TRUSTEE_IS_OBJECTS_AND_SID	Puntero a una estructura de 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 de confianza.

pSid

pObjectsAndSid

pObjectsAndName

Comentarios

Un nombre de administrador 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 "GUEST".

Uno de los siguientes nombres especiales.

Nombre	Significado
CREATOR GROUP	El CREATOR_GROUP SID es un SID que se usa en los ACE heredables. Cuando se crea un nuevo objeto, el sistema reemplaza este SID por el SID del grupo principal del usuario que creó el objeto.
CREATOR OWNER	El SID de CREATOR_OWNER es un SID que se usa en los ACE heredables. 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	accctrl.h