Интерфейс IADsNameTranslate (iads.h)

Статья
08/24/2023

Интерфейс IADsNameTranslate преобразует различающиеся имена (DN) в различные форматы, как определено в перечислении ADS_NAME_TYPE_ENUM . Эта функция доступна для объектов в Active Directory.

Преобразования имен выполняются на сервере каталогов. Чтобы преобразовать DN, взаимодействуйте с сервером с помощью объекта IADsNameTranslate и укажите, какой объект представляет интерес и какой формат требуется. Ниже приведен общий процесс использования интерфейса IADsNameTranslate .

Сначала создайте экземпляр объекта IADsNameTranslate .

Во-вторых, инициализируйте объект IADsNameTranslate , указав сервер каталогов с помощью
Методы IADsNameTranslate::Init или IADsNameTranslate::InitEx .

В-третьих, задайте объект каталога на сервере, указав имя с помощью метода IADsNameTranslate::Set и формат с помощью метода IADsNameTranslate::SetEx .

В-четвертых, извлеките имя объекта в указанном формате с помощью метода IADsNameTranslate::Get или IADsNameTranslate::GetEx .

В следующем примере кода показано, как создать объект IADsNameTranslate в Visual C++, Visual Basic и VBScript/Active Server Pages.

Примечание Элементы формата, определенные в перечислении ADS_NAME_TYPE_ENUM и используемые IADsNameTranslate , не эквивалентны и не являются взаимозаменяемыми с элементами форматирования, используемыми функцией DsCrackName . Не путайте правильное использование этих форматов элементов с аналогичными именами, но не взаимозаменяемых.

Наследование

Интерфейс IADsNameTranslate наследуется от интерфейса IDispatch . IADsNameTranslate также имеет следующие типы элементов:

Методы

Интерфейс IADsNameTranslate содержит следующие методы.


IADsNameTranslate::Get Извлекает имя объекта каталога в указанном формате.
IADsNameTranslate::GetEx Возвращает имена объектов в указанном формате.
IADsNameTranslate::Init Инициализирует объект преобразования имени путем привязки к указанному серверу каталогов, домену или глобальному каталогу, используя учетные данные текущего пользователя.
IADsNameTranslate::InitEx Инициализирует объект преобразования имени путем привязки к указанному серверу каталогов, домену или глобальному каталогу, используя указанные учетные данные пользователя.
IADsNameTranslate::Set Направляет службу каталогов на настройку указанного объекта для преобразования имен.
IADsNameTranslate::SetEx Устанавливает массив объектов для преобразования имен.

Требования


Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	iads.h