Raccolte e gruppi

ADSI usa oggetti raccolta per rappresentare qualsiasi set arbitrario di elementi in un servizio directory che può essere rappresentato usando lo stesso tipo di dati. Gli oggetti raccolta vengono definiti come set di valori VARIANT , che rappresentano uno dei tipi di dati di Automazione validi. Gli oggetti raccolta possono rappresentare informazioni persistenti, ad esempio elenchi di controllo di accesso e informazioni volatili, ad esempio i processi di stampa in una coda di stampa.

La convenzione COM standard per elencare il contenuto di un oggetto raccolta (o contenitore) consiste nel creare un oggetto enumeratore che supporta IEnumVARIANT, che dispone di metodi per scorrere l'elenco di oggetti raccolta. Le interfacce in ADSI che forniscono il metodo get__NewEnum (si noti che i due caratteri di sottolineatura) sono IADsContainer, IADsMembers e IADsCollection. ADSI fornisce anche le funzioni helper ADsBuildEnumerator e ADsEnumerateNext per i programmi C e C++ per semplificare l'enumerazione. I client di automazione usano l'enumerazione in modo implicito quando chiamano Next in un ciclo For .

I gruppi sono semplicemente raccolte di oggetti che supportano l'interfaccia IADsMembers .