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

Функция 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 .

Требования

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

Коды ошибок ADSI

Функции ADSI

ADsOpenObject

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