BG_BASIC_CREDENTIALS 结构 (bits1_5.h)

  • 项目

标识要进行身份验证的用户名和密码。

语法

typedef struct __MIDL_IBackgroundCopyJob2_0001 {
  LPWSTR UserName;
  LPWSTR Password;
} BG_BASIC_CREDENTIALS;

成员

UserName

一个以 null 结尾的字符串，其中包含要进行身份验证的用户名。 用户名限制为 300 个字符，不包括 null 终止符。 用户名的格式取决于请求的身份验证方案。 例如，对于 Basic、NTLM 和 Negotiate 身份验证，用户名的格式为 DomainName\UserName。 对于 Passport 身份验证，用户名是电子邮件地址。 有关详细信息，请参阅“备注”。

如果 为 NULL，则使用此会话上下文的默认凭据。

Password

以纯文本形式包含密码的以 null 结尾的字符串。 密码限制为 65536 个字符，不包括 null 终止符。 密码可以为空。 如果 UserName 为 NULL，则将其设置为 NULL。 如果发生网络断开连接或用户注销，BITS 会在保留作业之前加密密码。

通过 Negotiate 2 支持实时 ID 编码的密码。 有关 Live ID 的详细信息，请参阅 Windows Live ID SDK。

注解

以下列表根据请求的身份验证方案标识何时需要 UserName 和 Password 成员：

若要保护用户名和密码信息，请在使用 结构后调用 Winbase.h 中定义的 SecureZeroMemory 函数以清除 UserName 和 Password 缓冲区。

可以指定如下所示的用户名。

  • DomainName\UserName。 如果服务器位于域中，并且 DomainName 是服务器所属的域或受信任域，请使用DomainName UserName。\
  • ServerName\UserName。 如果帐户是服务器上的本地帐户，请使用 ServerName\UserName 。 ServerName 是对凭据进行身份验证的计算机的名称。
  • UserName。 如果仅指定 UserName，则用户的默认域名将作为用户名的前缀，并且将应用 DomainName\UserName 窗体的规则。 仅当用户是域的成员时，才使用此选项。
  • NULL。 若要使用用户的登录凭据进行 NTLM 或 Kerberos 身份验证，请将 UserName 设置为 NULL。 仅当用户位于受信任的域中时，这才有效。 将作为系统帐户运行的服务的 UserName 设置为 NULL 会通过计算机的凭据进行身份验证。 仅当域启用 Kerberos 身份验证，并且你选择“协商”作为身份验证方案时，此选项才有效。

要求

要求 值
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2003
标头 bits1_5.h (包括 Bits.h)
可再发行组件 Windows XP 上的 BITS 1.5

另请参阅

BG_AUTH_CREDENTIALS_UNION