ADsGetObject 函数 (adshlp.h)
ADsGetObject 函数在给定其路径和指定的接口标识符的情况下绑定到对象。
语法
HRESULT ADsGetObject(
[in] LPCWSTR lpszPathName,
[in] REFIID riid,
[out] VOID **ppObject
);
参数
[in] lpszPathName
类型： LPCWSTR
以 null 结尾的 Unicode 字符串，指定用于绑定到基础目录服务中的 对象的路径。 有关此参数绑定字符串的详细信息和代码示例，请参阅 LDAP ADsPath 和 WinNT ADsPath。
[in] riid
类型： REFIID
此对象上指定接口的接口标识符。
[out] ppObject
类型： VOID**
指向指向所请求接口的指针的指针的指针。
返回值
类型： HRESULT
此方法支持标准 HRESULT 返回值以及以下值。
有关其他返回值的详细信息，请参阅 ADSI 错误代码。
注解
C/C++ 客户端调用 ADsGetObject 帮助程序函数以绑定到 ADSI 对象。 它等效于调用 GetObject 函数的 Visual Basic 客户端。 它们都采用 ADsPath 作为输入，并返回指向所请求接口的指针。 默认情况下，绑定将 ADS_SECURE_AUTHENTICATION 选项与调用线程的安全上下文配合使用。 但是，如果身份验证失败，安全绑定将降级为匿名绑定，例如，没有用户凭据的简单绑定。 若要安全地绑定到 ADSI 对象，请使用 ADsOpenObject 函数而不是 ADsGetObject 函数。
有关演示如何使用 ADsOpenObject 的代码示例，请参阅 使用 GetObject 和 ADsGetObject 绑定。
可以使用与当前登录用户不同的用户凭据绑定到 ADSI 对象。 若要执行此操作，请使用 ADsOpenObject 函数。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 最低受支持的服务器 | Windows Server 2008 |
| 目标平台 | Windows |
| 标头 | adshlp.h |
| Library | Activeds.lib |
| DLL | Activeds.dll |