estructura OBJECTS_AND_NAME_A (accctrl.h)

Artículo
11/20/2024

La estructura OBJECTS_AND_NAME contiene una cadena que identifica un administrador de confianza por nombre y cadenas adicionales que identifican los tipos de objeto de un entrada de control de acceso específico de un objeto (ACE).

Sintaxis

typedef struct _OBJECTS_AND_NAME_A {
  DWORD          ObjectsPresent;
  SE_OBJECT_TYPE ObjectType;
  LPSTR          ObjectTypeName;
  LPSTR          InheritedObjectTypeName;
  LPSTR          ptstrName;
} OBJECTS_AND_NAME_A, *POBJECTS_AND_NAME_A;

Miembros

ObjectsPresent

Indica si los miembros ObjectTypeName y InheritedObjectTypeName contienen cadenas. Este parámetro puede ser una combinación de los siguientes valores.

Valor	Significado
ACE_OBJECT_TYPE_PRESENT 0x1	El miembro ObjectTypeName contiene una cadena.
ACE_INHERITED_OBJECT_TYPE_PRESENT 0x2	El miembro InheritedObjectTypeName contiene una cadena.

ObjectType

Especifica un valor de la enumeración SE_OBJECT_TYPE que indica el tipo de objeto.

ObjectTypeName

Puntero a una cadena terminada en NULL que identifica el tipo de objeto al que se aplica la ACE.

Esta cadena debe ser un LDAP válido nombre para mostrar en el esquema de Active Directory.

InheritedObjectTypeName

Puntero a una cadena terminada en NULL que identifica el tipo de objeto que puede heredar la ACE.

Esta cadena debe ser un LDAP válido nombre para mostrar en el esquema de Active Directory.

Si el bit de ACE_INHERITED_OBJECT_TYPE_PRESENT no se establece en el miembro ObjectsPresent, se omite el miembro InheritedObjectTypeName y todos los tipos de objetos secundarios pueden heredar la ACE. De lo contrario, solo el tipo de objeto especificado puede heredar la ACE. En cualquier caso, la herencia también se controla mediante las marcas de herencia de la estructura ACE_HEADER, así como cualquier protección contra la herencia colocada en los objetos secundarios.

ptstrName

Puntero a una cadena terminada en null que contiene el nombre del administrador de confianza.

Observaciones

El miembro ptstrName de de una estructura TRUSTEE de puede ser un puntero a una estructura OBJECTS_AND_NAME. Esto permite funciones como SetEntriesInAcl y GetExplicitEntriesFromAcl almacenar información ace específica del objeto en el miembro de Trustee de una estructura de EXPLICIT_ACCESS.

Nota

El encabezado accctrl.h define OBJECTS_AND_NAME_ 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