BG_AUTH_SCHEME Enumeration

The BG_AUTH_SCHEME enumeration defines the constant values that specify the authentication scheme to use when a proxy or server requests user authentication.

Syntax

typedef enum __MIDL_IBackgroundCopyJob2_0002 {
  BG_AUTH_SCHEME_BASIC,
  BG_AUTH_SCHEME_DIGEST,
  BG_AUTH_SCHEME_NTLM,
  BG_AUTH_SCHEME_NEGOTIATE,
  BG_AUTH_SCHEME_PASSPORT
} BG_AUTH_SCHEME;

Constants

BG_AUTH_SCHEME_BASIC Basic is a scheme in which the user name and password are sent in clear-text to the server or proxy.
BG_AUTH_SCHEME_DIGEST Digest is a challenge-response scheme that uses a server-specified data string for the challenge.
BG_AUTH_SCHEME_NTLM NTLM is a challenge-response scheme that uses the credentials of the user for authentication in a Windows network environment.
BG_AUTH_SCHEME_NEGOTIATE Simple and Protected Negotiation protocol (Snego) is a challenge-response scheme that negotiates with the server or proxy to determine which scheme to use for authentication. Examples are the Kerberos protocol and NTLM.
BG_AUTH_SCHEME_PASSPORT Passport is a centralized authentication service provided by Microsoft that offers a single logon for member sites.

Remarks

BITS supports Passport authentication for explicit credentials only, not implicit credentials tied to the account.

The following table shows the authentication requests that BITS does not support.

Scenario not supported Windows Server 2003 Windows XP
Passport authentication on the server when the proxy requires authentication (using the HTTPS protocol). Not supported Not supported
Any authentication scheme on the server when the proxy requires Digest authentication. Not supported Not supported
Negotiate authentication on the server when the proxy requires Basic authentication. Not supported
Using HTTPS when the proxy requires Digest authentication. Not supported

Requirements

   
Minimum supported client Windows Vista
Minimum supported server Windows Server 2003
Header bits1_5.h (include Bits.h)
Redistributable BITS 1.5 on Windows XP

See Also

Authentication

BG_AUTH_CREDENTIALS

IBackgroundCopyJob2::SetCredentials