estructura OBJECTS_AND_NAME_A (accctrl.h)

Artículo
08/22/2023

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 una entrada de control de acceso (ACE) específica del objeto.

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 valores siguientes.

Value	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 nombre para mostrar LDAP válido 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 nombre para mostrar LDAP válido 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 por 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.

Comentarios

El miembro ptstrName de una estructura TRUSTEE puede ser un puntero a una estructura OBJECTS_AND_NAME . Esto permite que las funciones como SetEntriesInAcl y GetExplicitEntriesFromAcl almacenen información ace específica del objeto en el miembro de confianza 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 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