ADsGetObject 函数 (adshlp.h)

ADsGetObject 函数绑定到给定其路径和指定接口标识符的对象。

语法

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

参数

[in] lpszPathName

类型: LPCWSTR

以 null 结尾的 Unicode 字符串,指定用于绑定到基础目录服务中的对象的路径。 有关此参数绑定字符串的详细信息和代码示例,请参阅 LDAP ADsPathWinNT 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

请参阅

ADSI 错误代码

ADSI 函数

ADsOpenObject

使用 GetObject 和 ADsGetObject 绑定