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 |