Поделиться через


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

Интерфейс 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

См. также раздел

ADS_NAME_TYPE_ENUM

CoCreateInstance

Методы свойств IADsNameTranslate

Интерфейс IADsNameTranslate

IADsNameTranslate::Get

IADsNameTranslate::GetEx

IADsNameTranslate::Init

IADsNameTranslate::InitEx

IADsNameTranslate::Set

IADsNameTranslate::SetEx

IDispatch