IADsPropertyList-Schnittstelle (iads.h)
Die IADsPropertyList-Schnittstelle wird verwendet, um eine Liste von Eigenschaftseinträgen im Eigenschaftencache eines Objekts zu ändern, zu lesen und zu aktualisieren. Sie dient zum Auflisten, Ändern und Bereinigen der enthaltenen Eigenschaftseinträge. Verwenden Sie die Enumerationsmethode dieser Schnittstelle, um initialisierte Eigenschaften zu identifizieren. Dies unterscheidet sich von der Verwendung des Schemas, um alle möglichen Attribute zu bestimmen, die ein ADSI-Objekt aufweisen kann und welche Eigenschaften festgelegt wurden.
Rufen Sie die Methoden der IADsPropertyList-Schnittstelle auf, um die Eigenschaftenliste auf dem Client zu untersuchen und zu bearbeiten. Bevor Sie die Methoden dieser Schnittstelle aufrufen, müssen Sie IADs::GetInfo oder IADs::GetInfoEx explizit aufrufen, um die zugewiesenen Eigenschaftswerte des Objekts in den Cache zu laden. Nachdem Sie die Methoden dieser Schnittstelle aufgerufen haben, müssen Sie IADs::SetInfo aufrufen, um die Änderungen im persistenten Speicher des zugrunde liegenden Verzeichnisses zu speichern.
Um die Eigenschaftenliste eines ADSI-Objekts abzurufen, binden Sie an die IADsPropertyList-Schnittstelle . Sie müssen die GetInfo-Methode aufrufen, bevor Sie andere Methoden des Eigenschaftenlistenobjekts aufrufen, wenn der Eigenschaftencache nicht initialisiert wurde.
Vererbung
Die IADsPropertyList-Schnittstelle erbt von der IDispatch-Schnittstelle . IADsPropertyList verfügt auch über die folgenden Typen von Membern:
Methoden
Die IADsPropertyList-Schnittstelle verfügt über diese Methoden.
| IADsPropertyList::GetPropertyItem Ruft das Element ab, das mit dem Namen aus der Liste übereinstimmt. |
| IADsPropertyList::Item Die IADsPropertyList::Item-Methode ruft das angegebene Eigenschaftselement aus der Liste ab. |
| IADsPropertyList::Weiter Die IADsPropertyList::Next-Methode ruft das nächste Element in der Eigenschaftenliste ab. Das zurückgegebene Element ist ein Property Entry-Objekt. |
| IADsPropertyList::P urgePropertyList Löscht alle Elemente aus der Eigenschaftenliste. |
| IADsPropertyList::P utPropertyItem Updates die Werte für ein Element in der Eigenschaftenliste. |
| IADsPropertyList::Reset Setzt die Liste auf das erste Element zurück. |
| IADsPropertyList::ResetPropertyItem Entfernt das angegebene Element aus der Liste. d. h. aus dem Cache. |
| IADsPropertyList::Skip Überspringt eine angegebene Anzahl von Elementen, die von der aktuellen Cursorposition aus in der Eigenschaftenliste gezählt werden. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | iads.h |