Share via


Accesso alla cache delle proprietà con interfacce IADsProperty

Le interfacce IADsProperty sono costituite da IADsPropertyList, IADsPropertyEntry e IADsPropertyValue. Queste interfacce forniscono metodi per accedere direttamente e modificare le proprietà di una cache di oggetti. Una proprietà è nota come voce di proprietà e corrisponde a un attributo definito nello schema. Una voce di proprietà può avere uno o più valori di proprietà. Un set di voci di proprietà è organizzato come elenco di proprietà.

L'interfaccia IADsPropertyList gestisce l'elenco delle proprietà di un oggetto ADSI. L'interfaccia IADsPropertyEntry esegue questa operazione per una voce di proprietà. Analogamente, l'interfaccia IADsPropertyValue rappresenta uno o più valori di proprietà. Insieme, forniscono un meccanismo che consente agli utenti di:

  • Usare direttamente la cache delle proprietà.
  • Usare le directory che non contengono schemi, ad esempio un server LDAP versione 2.

Le interfacce IADsProperty* operano rigorosamente nella cache delle proprietà e non tentano di collaborare con il server per recuperare o modificare i dati nell'archivio permanente. Di conseguenza, queste interfacce vengono usate solo per esaminare e modificare le proprietà nella cache client. Prima di usare queste interfacce, è necessario chiamare il metodo IADs::GetInfo o il metodo IADs::GetInfoEx in modo esplicito per caricare le proprietà dell'oggetto nella cache, se la cache non è stata inizializzata. Dopo aver chiamato i metodi di queste interfacce, è necessario chiamare IADs::SetInfo per rendere persistenti le modifiche all'archivio directory sottostante.

Per altre informazioni e un esempio di codice che può essere usato per implementare queste interfacce, vedere Codice di esempio per l'uso di interfacce IADsProperty per accedere alla cache delle proprietà.