Accesso e modifica dei dati con ADSI

  • Articolo

Tutti gli oggetti hanno proprietà. Tutti gli oggetti COM active Directory Service Interface (ADSI) dispongono di una o più interfacce con metodi che recuperano le proprietà dell'oggetto directory rappresentato dall'oggetto COM. Esistono diversi modi per leggere le proprietà da un oggetto:

  • Ottenere una proprietà specifica in base al nome: l'interfaccia IADs include due metodi IADs::Get e IADs::GetEx per leggere una proprietà specifica. Ogni oggetto COM ADSI dispone di un'interfaccia IAD .
  • Ottiene un elenco specificato di proprietà: l'interfaccia IDirectoryObject include il metodo IDirectoryObject::GetObjectAttributes che consente di specificare un elenco contenente i nomi delle proprietà da leggere e restituisce una matrice di strutture contenenti i valori delle proprietà richieste.
  • Enumerare tutte le proprietà dell'oggetto: l'interfaccia IADsPropertyList consente di enumerare tutte le proprietà di un oggetto .
  • Ottenere proprietà speciali: le interfacce di automazione (IADs*) dispongono di metodi di proprietà che consentono di ottenere proprietà speciali non archiviate in un oggetto. In alternativa, i metodi di proprietà possono consentire di ottenere una proprietà dell'oggetto in un formato di dati diverso dal tipo di dati effettivo archiviato. Ad esempio, l'interfaccia IAD include metodi di proprietà come IADs::get_Name, che recupera il nome distinto relativo di un oggetto (RDN); IADs::get_Class, che recupera la classe di un oggetto e IADs::get_Parent, che recupera l'ADsPath nell'elemento padre dell'oggetto.

ADSI consente di memorizzare nella cache le proprietà in locale dopo che sono state lette dal server di directory. In questo modo è possibile scegliere di leggere le proprietà dalla cache delle proprietà locali o recuperare le proprietà direttamente dal server di directory. ADSI include anche metodi per aggiornare la cache e specificare se tutte le proprietà per un oggetto vengono memorizzate nella cache o solo quelle specificate.

Dopo aver recuperato una proprietà, leggerne il valore. Il tipo di dati di una proprietà dipende dalla definizione della proprietà (nota anche come attributo) nello schema di Active Directory. Per ogni tipo di proprietà che può esistere in Active Directory, è presente un oggetto attributeSchema nello schema di Active Directory. Un oggetto attributeSchema definisce le caratteristiche dell'attributo. Una di queste caratteristiche è la sintassi dell'attributo, che determina il tipo di dati dei valori dell'attributo. Per altre informazioni, vedere Caratteristiche degli attributi e delle sintassi per gli attributi di Active Directory.

Le interfacce di automazione (IAD*) restituiscono un valore della proprietà come VARIANT o un puntatore a un'interfaccia di automazione in un oggetto COM che rappresenta la proprietà. Le interfacce IDirectoryObject e IDirectorySearch restituiscono una proprietà come puntatore a una struttura contenente un valore della proprietà tipizzata o un puntatore a una stringa di byte. Inoltre, IDirectoryObject e IDirectorySearch recuperano le proprietà direttamente dal server directory anziché usare una cache delle proprietà locale.

In questa sezione vengono descritti gli argomenti seguenti: