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

另请参阅

ADSI 错误代码

ADSI 函数

ADsOpenObject

使用 GetObject 和 ADsGetObject 进行绑定