Функция 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 .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | adshlp.h |
| Библиотека | Activeds.lib |
| DLL | Activeds.dll |