Zugreifen auf Eigenschaftencache mit IADsProperty-Schnittstellen
Die IADsProperty-Schnittstellen bestehen aus IADsPropertyList, IADsPropertyEntry und IADsPropertyValue. Diese Schnittstellen stellen Methoden bereit, um direkt auf die Eigenschaften eines Objektcaches zuzugreifen und diese zu bearbeiten. Eine Eigenschaft wird als Eigenschaftseintrag bezeichnet und entspricht einem im Schema definierten Attribut. Ein Eigenschaftseintrag kann einen oder mehrere Eigenschaftswerte aufweisen. Eine Reihe von Eigenschaftseinträgen werden als Eigenschaftenliste organisiert.
Die IADsPropertyList-Schnittstelle verwaltet die Eigenschaftenliste eines ADSI-Objekts. Die IADsPropertyEntry-Schnittstelle führt diesen Vorgang für einen Eigenschaftseintrag aus. In ähnlicher Weise stellt die IADsPropertyValue-Schnittstelle einen oder mehrere Eigenschaftswerte dar. Zusammen stellen sie einen Mechanismus für Benutzer bereit, um Folgendes zu ermöglichen:
- Arbeiten Sie direkt mit dem Eigenschaftencache.
- Arbeiten Sie mit Verzeichnissen, die keine Schemas enthalten, z. B. einen LDAP-Server der Version 2.
Die IADsProperty*-Schnittstellen arbeiten streng im Eigenschaftencache und versuchen nicht, mit dem Server zusammenzuarbeiten, um die Daten im persistenten Speicher abzurufen oder zu ändern. Daher werden diese Schnittstellen nur verwendet, um Eigenschaften im Clientcache zu untersuchen und zu bearbeiten. Bevor Sie diese Schnittstellen verwenden, müssen Sie die IADs::GetInfo-Methode oder die IADs::GetInfoEx-Methode aufrufen, um die Objekteigenschaften explizit in den Cache zu laden, wenn der Cache nicht initialisiert wurde. Nachdem Sie die Methoden dieser Schnittstellen aufgerufen haben, müssen Sie IADs::SetInfo aufrufen, um die Änderungen im zugrunde liegenden Verzeichnisspeicher beizubehalten.
Weitere Informationen und ein Codebeispiel, mit dem diese Schnittstellen implementiert werden können, finden Sie unter Beispielcode für die Verwendung von IADsProperty-Schnittstellen für den Zugriff auf den Eigenschaftencache.