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

另請參閱

BG_AUTH_CREDENTIALS_UNION