Erstellen und Löschen von Objekten
Mit ADSI werden Objekte entweder mithilfe der IADsContainer - oder IDirectoryObject-Schnittstelle erstellt und gelöscht.
Erstellen eines Objekts mit IADsContainer
So erstellen Sie ein Objekt mit der IADsContainer-Schnittstelle
- Binden Sie an den Container, der das zu erstellende Objekt enthält, und rufen Sie die IADsContainer-Schnittstelle ab.
- Verwenden Sie die IADsContainer.Create-Methode , um ein neues Objekt im Container zu erstellen.
- Legen Sie die Werte für alle erforderlichen Attribute für das Objekt mithilfe der IADs.Put - oder IADs.PutEx-Methode fest. Die zum Erstellen eines Objekts erforderlichen Attribute hängen vom Verzeichnisdienst und vom Typ des erstellten Objekts ab. Weitere Informationen zum Erstellen von Active Directory-Objekten finden Sie unter Erstellen und Löschen von Active Directory-Objekten.
- Legen Sie die Werte für alle gewünschten optionalen Attribute für das Objekt mithilfe der IADs.Put - oder IADs.PutEx-Methode fest.
- Rufen Sie die IADs.SetInfo-Methode auf, um das Objekt und seine Attribute zu committen. Das neue Objekt wird erst im zugrunde liegenden Verzeichnisdienst erstellt, wenn die IADs.SetInfo-Methode aufgerufen wird, um die Attribute zu committen.
Erstellen eines Objekts mit IDirectoryObject
So erstellen Sie ein Objekt mit der IDirectoryObject-Schnittstelle
- Binden Sie an den Container, der das zu erstellende Objekt enthält, und rufen Sie die IDirectoryObject-Schnittstelle ab.
- Ordnen Sie ein Array von ADS_ATTR_INFO Strukturen zu, das eine Struktur für jedes Attribut enthält, das beim Erstellen des Objekts festgelegt werden soll.
- Geben Sie eine ADS_ATTR_INFO-Struktur für jedes erforderliche Attribut für das Objekt ein. Die zum Erstellen eines Objekts erforderlichen Attribute hängen vom Verzeichnisdienst und vom Typ des erstellten Objekts ab. Weitere Informationen zum Erstellen von Active Directory-Objekten finden Sie unter Erstellen und Löschen von Active Directory-Objekten.
- Geben Sie eine ADS_ATTR_INFO-Struktur für jedes optionale Attribut für das Objekt ein.
- Verwenden Sie die IDirectoryObject::CreateDSObject-Methode , um das Objekt im Container zu erstellen. Diese Methode committet auch das Objekt an den zugrunde liegenden Verzeichnisdienst. Wenn das ADS_ATTR_INFO Array nicht alle erforderlichen Attribute für das Objekt enthält, schlägt IDirectoryObject::CreateDSObject fehl.
Löschen eines Objekts
Verwenden Sie zum Löschen eines Objekts die Methode IADsContainer::D elete oder IDirectoryObject::D eleteDSObject . Diese Methoden schlagen fehl, wenn das gelöschte Objekt untergeordnete Objekte enthält. Verwenden Sie die IADsDeleteOps::D eleteObject-Methode , um einen Container und alle untergeordneten Objekte des Containers zu löschen.
Was mit einem gelöschten Objekt geschieht, hängt vom zugrunde liegenden Verzeichnisdienst ab. Weitere Informationen zum Löschen von Active Directory-Objekten finden Sie unter Erstellen und Löschen von Active Directory-Objekten.