DsBindA 函数（ntdsapi.h）

DsBind 函数绑定到域控制器。DsBind 使用默认进程凭据绑定到域控制器。若要指定备用凭据，请使用 DsBindWithCred 函数。

语法

NTDSAPI DWORD DsBindA(
  [in, optional] LPCSTR DomainControllerName,
  [in, optional] LPCSTR DnsDomainName,
  [out]          HANDLE *phDS
);

[in, optional] DomainControllerName

指向包含要绑定到的域控制器名称的 null 终止字符串的指针。此名称可以是域控制器的名称，也可以是域控制器的完全限定 DNS 名称。任一名称类型都可以（可选）前面有两个反斜杠字符。以下所有示例都表示格式正确的域控制器名称：

此参数可以 NULL。有关详细信息，请参阅“备注”。

[in, optional] DnsDomainName

指向包含要绑定到的域的完全限定 DNS 名称的以 null 结尾的字符串的指针。此参数可以 NULL。有关详细信息，请参阅“备注”。

[out] phDS

接收绑定句柄的 HANDLE 值的地址。若要关闭此句柄，请将其传递给 DsUnBind 函数。

如果成功，则返回 ERROR_SUCCESS;否则返回 Windows 或 RPC 错误代码。以下是最常见的错误代码。

DsBind 函数的行为由 DomainControllerName 和 DnsDomainName 参数的内容确定。以下列表根据这些参数的内容描述此函数的行为。

DomainControllerName	DnsDomainName	描述
NULL	NULL	DsBind 将尝试绑定到本地计算机的林中的全局编录服务器。
（值）	NULL	DsBind 将尝试绑定到由 DomainControllerName 参数指定的域控制器。
NULL	（值）	DsBind 将尝试绑定到由 DnsDomainName 参数指定的域中的任何域控制器。
（value )	（值）	DomainControllerName 参数优先。 DsBind 将尝试绑定到由 DomainControllerName 参数指定的域控制器。

注意

ntdsapi.h 标头将 DsBind 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。