IConnectedIdentityProvider::ConnectIdentity 方法 (identityprovider.h)

将标识连接到域用户。

语法

HRESULT ConnectIdentity(
  [in] BYTE  *AuthBuffer,
  [in] ULONG AuthBufferSize
);

parameters

[in] AuthBuffer

封送身份验证缓冲区 SEC_WINNT_AUTH_IDENTITY_EX2 包含联机标识凭据的结构。 调用方可以通过将 CredPackAuthenticationBuffer 函数与 CRED_PACK_ID_PROVIDER_CREDENTIALS 选项结合使用来构造缓冲区,或者由 CredUIPromptForWindowsCredentials 函数的联机标识凭据提供程序返回。 可以使用 SEC_WINNT_AUTH_IDENTITY_ENCRYPT_SAME_LOGON 选项调用 SspiEncryptAuthIdentityEx 函数来选择性地加密缓冲区。

[in] AuthBufferSize

AuthBuffer 参数的大小(以字节为单位)。

返回值

如果方法成功,则 返回S_OK。

如果方法失败,则返回 Win32 错误代码。

返回代码 说明
S_OK
方法成功。
ERROR_LOGON_FAILURE
用户名或密码不正确。
ERROR_USER_EXISTS
域用户已连接此提供商的联机标识或与之关联。
ERROR_INVALID_ACCOUNT_NAME
联机用户名的格式无效。

注解

如果在安全桌面上收集凭据,则可以在系统上下文中加密 AuthBuffer 参数。 在这种情况下,标识提供者无法在当前进程中解密凭据。 若要解密缓冲区,标识提供者需要将凭据发送到在系统上下文中运行的进程。

要求

   
最低受支持的客户端 Windows 8 [仅限桌面应用]
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 identityprovider.h

另请参阅

IConnectedIdentityProvider