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 會先加密密碼，再保存作業。
透過交涉 2 支援即時識別碼的密碼。 如需即時識別碼的詳細資訊，請參閱 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 |