Функция ADsGetObject (adshlp.h)

Статья
08/22/2023

Функция ADsGetObject привязывается к объекту по заданному пути и указанному идентификатору интерфейса.

Синтаксис

HRESULT ADsGetObject(
  [in]  LPCWSTR lpszPathName,
  [in]  REFIID  riid,
  [out] VOID    **ppObject
);

Параметры

[in] lpszPathName

Тип: LPCWSTR

Строка Юникода, завершающаяся null, которая указывает путь, используемый для привязки к объекту в базовой службе каталогов. Дополнительные сведения и примеры кода для строк привязки для этого параметра см. в разделах LDAP ADsPath и WinNT ADsPath.

[in] riid

Тип: REFIID

Идентификатор интерфейса для указанного интерфейса в этом объекте.

[out] ppObject

Тип: VOID**

Указатель на указатель на запрошенный интерфейс.

Возвращаемое значение

Тип: HRESULT

Этот метод поддерживает стандартные возвращаемые значения HRESULT , а также следующие.

Дополнительные сведения о других возвращаемых значениях см. в разделе Коды ошибок ADSI.

Клиент C/C++ вызывает вспомогающую функцию ADsGetObject для привязки к объекту ADSI. Это эквивалентно вызову клиентом Visual Basic функции GetObject . Они принимают ADsPath в качестве входных данных и возвращают указатель на запрошенный интерфейс. По умолчанию привязка использует параметр ADS_SECURE_AUTHENTICATION с контекстом безопасности вызывающего потока. Однако в случае сбоя проверки подлинности безопасная привязка понижается до анонимной привязки, например простой привязки без учетных данных пользователя. Для безопасной привязки к объекту ADSI используйте функцию ADsOpenObject вместо функции ADsGetObject .

Пример кода, демонстрирующий использование ADsOpenObject, см. в разделах Привязка с помощью GetObject и ADsGetObject.

Можно выполнить привязку к объекту ADSI с учетными данными пользователя, отличными от учетных данных текущего пользователя, выполнившего вход. Для выполнения этой операции используйте функцию ADsOpenObject .

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	adshlp.h
Библиотека	Activeds.lib
DLL	Activeds.dll

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

Коды ошибок ADSI

Функции ADSI

ADsOpenObject

Привязка с помощью GetObject и ADsGetObject

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