IADsNameTranslate-Schnittstelle (iads.h)
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.
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 |
Weitere Informationen
Methoden der IADsNameTranslate-Eigenschaft