struttura OBJECTS_AND_NAME_A (accctrl.h)

Articolo
11/20/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;

Membri

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 LDAP nome visualizzato 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 LDAP nome visualizzato valido nello schema di Active Directory.

Se il bit di 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 nonché da qualsiasi protezione contro l'ereditarietà inserita negli oggetti figlio.

ptstrName

Puntatore a una stringa con terminazione Null contenente il nome del trustee.

Osservazioni

Il ptstrName membro di una struttura TRUSTEEE può essere un puntatore a una struttura OBJECTS_AND_NAME. In questo modo, le funzioni come SetEntriesInAcl e GetExplicitEntriesFromAcl per 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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.