OBJECTS_AND_NAME_A struttura (accctrl.h)

Articolo
02/23/2024

La struttura OBJECTS_AND_NAME contiene una stringa che identifica un trustee per nome e stringhe aggiuntive che identificano i tipi di oggetto di una voce di controllo di accesso specifica dell'oggetto (ACE).

Sintassi

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;

Members

ObjectsPresent

Indica se i membri ObjectTypeName e InheritedObjectTypeName contengono stringhe. Questo parametro può essere una combinazione dei valori seguenti.

Valore	Significato
ACE_OBJECT_TYPE_PRESENT 0x1	Il membro ObjectTypeName contiene una stringa.
ACE_INHERITED_OBJECT_TYPE_PRESENT 0x2	Il membro InheritedObjectTypeName contiene una stringa.

ObjectType

Specifica un valore dell'enumerazione SE_OBJECT_TYPE che indica il tipo di oggetto.

ObjectTypeName

Puntatore a una stringa con terminazione null che identifica il tipo di oggetto a cui si applica l'ACE.

Questa stringa deve essere un nome visualizzato LDAP valido nello schema di Active Directory.

InheritedObjectTypeName

Puntatore a una stringa con terminazione null che identifica il tipo di oggetto che può ereditare l'ACE.

Questa stringa deve essere un nome visualizzato LDAP valido nello schema di Active Directory.

Se il bit ACE_INHERITED_OBJECT_TYPE_PRESENT non è impostato nel membro ObjectsPresent , il membro InheritedObjectTypeName viene ignorato e tutti i tipi di oggetti figlio possono ereditare l'ACE. In caso contrario, solo il tipo di oggetto specificato può ereditare l'ACE. In entrambi i casi, l'ereditarietà è controllata anche dai flag di ereditarietà nella struttura ACE_HEADER e da qualsiasi protezione contro l'ereditarietà inserita negli oggetti figlio.

ptstrName

Puntatore a una stringa con terminazione null contenente il nome dell'utente attendibile.

Commenti

Il membro ptstrName di una struttura TRUSTEE può essere un puntatore a una struttura OBJECTS_AND_NAME . In questo modo, le funzioni, ad esempio SetEntriesInAcl e GetExplicitEntriesFromAcl , consentono di archiviare informazioni ACE specifiche dell'oggetto nel membro Trustee di una struttura EXPLICIT_ACCESS .

Nota

L'intestazione accctrl.h definisce OBJECTS_AND_NAME_ come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.