Condividi tramite

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'interfacciaIADsinclude due metodi IADs::Get e IADs::GetEx per leggere una proprietà specifica. Ogni oggetto COM ADSI ha un'interfaccia IADs.
  • Ottiene un elenco specificato di proprietà: l'interfacciaIDirectoryObjectha 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'interfacciaIADsPropertyListconsente di enumerare tutte le proprietà di un oggetto.
  • Ottenere proprietà speciali: le interfacce di Automazione (ID*) 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 IADs include metodi di proprietà, ad esempio 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à, puoi 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 sintassi di per attributi di Active Directory.

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

In questa sezione vengono descritti gli argomenti seguenti: