IADsNameTranslate-Schnittstelle (iads.h)

Artikel
08/24/2023

Die IADsNameTranslate-Schnittstelle übersetzt Distinguished Names (DNs) zwischen verschiedenen Formaten, wie in der ADS_NAME_TYPE_ENUM-Enumeration definiert. Das Feature ist für Objekte in Active Directory verfügbar.

Namensübersetzungen werden auf dem Verzeichnisserver durchgeführt. Um einen DN zu übersetzen, kommunizieren Sie mit dem Server über ein IADsNameTranslate-Objekt , und geben Sie an, welches Objekt von Interesse ist und welches Format gewünscht wird. Im Folgenden wird der allgemeine Prozess für die Verwendung der IADsNameTranslate-Schnittstelle beschrieben.

Erstellen Sie zunächst eine instance des IADsNameTranslate-Objekts.

Initialisieren Sie anschließend das IADsNameTranslate-Objekt , indem Sie den Verzeichnisserver mithilfe des
Die Methoden IADsNameTranslate::Init oder IADsNameTranslate::InitEx .

Legen Sie drittens das Verzeichnisobjekt auf dem Server fest, indem Sie den Namen mit der IADsNameTranslate::Set-Methode und das Format mit der IADsNameTranslate::SetEx-Methode angeben.

Viertens: Rufen Sie den Objektnamen im angegebenen Format mit der IADsNameTranslate::Get - oder IADsNameTranslate::GetEx-Methode ab.

Das folgende Codebeispiel zeigt, wie Ein IADsNameTranslate-Objekt in Visual C++, Visual Basic und VBScript/Active Server Pages erstellt wird.

Hinweis Die in der ADS_NAME_TYPE_ENUM-Enumeration definierten und von IADsNameTranslate verwendeten Formatelemente sind nicht gleichwertig und können nicht mit den Formatelementen ausgetauscht werden, die von der DsCrackName-Funktion verwendet werden. Verwechseln Sie nicht die ordnungsgemäße Verwendung dieser ähnlich benannten, aber nicht austauschbaren Elementformate.

Vererbung

Die IADsNameTranslate-Schnittstelle erbt von der IDispatch-Schnittstelle . IADsNameTranslate verfügt auch über folgende Membertypen:

Methoden

Die IADsNameTranslate-Schnittstelle verfügt über diese Methoden.


IADsNameTranslate::Get Ruft den Namen eines Verzeichnisobjekts im angegebenen Format ab.
IADsNameTranslate::GetEx Ruft die Objektnamen im angegebenen Format ab.
IADsNameTranslate::Init Initialisiert ein Namensübersetzungsobjekt durch Bindung an einen angegebenen Verzeichnisserver, eine domäne oder einen globalen Katalog unter Verwendung der Anmeldeinformationen des aktuellen Benutzers.
IADsNameTranslate::InitEx Initialisiert ein Namensübersetzungsobjekt durch Bindung an einen angegebenen Verzeichnisserver, eine domäne oder einen globalen Katalog unter Verwendung der angegebenen Benutzeranmeldeinformationen.
IADsNameTranslate::Set Weist den Verzeichnisdienst an, ein angegebenes Objekt für die Namensübersetzung einzurichten.
IADsNameTranslate::SetEx Richtet ein Array von Objekten für die Namensübersetzung ein.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	iads.h