DsMakePasswordCredentialsA 函数 (ntdsapi.h)

项目
02/29/2024

DsMakePasswordCredentials 函数构造适用于 DsBindWithCred 函数的凭据句柄。

语法

NTDSAPI DWORD DsMakePasswordCredentialsA(
  [in]  LPCSTR                   User,
  [in]  LPCSTR                   Domain,
  [in]  LPCSTR                   Password,
  [out] RPC_AUTH_IDENTITY_HANDLE *pAuthIdentity
);

参数

[in] User

指向以 null 结尾的字符串的指针，该字符串包含要用于凭据的用户名。

[in] Domain

指向以 null 结尾的字符串的指针，该字符串包含用户所属的域。

[in] Password

指向以 null 结尾的字符串的指针，该字符串包含要用于凭据的密码。

[out] pAuthIdentity

指向接收凭据句柄的RPC_AUTH_IDENTITY_HANDLE 值的指针。此句柄用于对 DsBindWithCred 的后续调用。当不再需要时，必须使用 DsFreePasswordCredentials 函数释放此句柄。

返回值

返回 Windows 错误代码，包括以下内容。

注解

如果用户、域和密码均为 NULL，则创建一个 null 的默认凭据句柄。否则，用户必须存在。当 User 完全限定时，域参数可能为 NULL，例如 UPN 格式的用户;例如“someone@fabrikam.com”。

将 pAuthIdentity 中返回的句柄传递给 DsBindWithCred 时，必须先调用 DsUnBind ，然后再使用 DsFreePasswordCredentials 释放句柄。正常顺序为：

调用 DsMakePasswordCredentials 以获取凭据句柄。
调用 DsBindWithCred 并传递凭据句柄。
不再需要绑定时调用 DsUnbind 。
调用 DsFreePasswordCredentials 以释放凭据句柄。

注意

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

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	ntdsapi.h
Library	Ntdsapi.lib
DLL	Ntdsapi.dll