BINDF2 enumeration

Defines flags that specify how a resource is bound to a moniker. This type extends the BINDF enumerated type.

Syntax


typedef enum  { 
  BINDF2_DISABLEBASICOVERHTTP               = 0x00000001,
  BINDF2_DISABLEAUTOCOOKIEHANDLING          = 0x00000002,
  BINDF2_READ_DATA_GREATER_THAN_4GB         = 0x00000004,
  BINDF2_DISABLE_HTTP_REDIRECT_XSECURITYID  = 0x00000008,
  BINDF2_SETDOWNLOADMODE                    = 0x00000020,
  BINDF2_DISABLE_HTTP_REDIRECT_CACHING      = 0x00000040,
  BINDF2_RESERVED_A                         = 0x00400000,
  BINDF2_RESERVED_9                         = 0x00800000,
  BINDF2_RESERVED_8                         = 0x01000000,
  BINDF2_RESERVED_7                         = 0x02000000,
  BINDF2_RESERVED_6                         = 0x04000000,
  BINDF2_RESERVED_5                         = 0x08000000,
  BINDF2_RESERVED_4                         = 0x10000000,
  BINDF2_RESERVED_3                         = 0x20000000,
  BINDF2_RESERVED_2                         = 0x40000000,
  BINDF2_RESERVED_1                         = 0x80000000
} BINDF2;

Constants

BINDF2_DISABLEBASICOVERHTTP

Disable basic authentication over HTTP. The name of this enumeration value is a contraction of the string, "DISABLE BASIC OVER HTTP".

Note You could enable and disable such authentication prior to Internet Explorer 8, but it was not easy to control.

The following algorithm determines whether to disable authentication:

If you use the BINDF2_DISABLEBASICOVERHTTP flag in the bind operation:
- And if an HTTP Auth request (error code 401) arrives during the bind
- And if the connection is not HTTPS
- And if authentication is basic (not challenge response, such as digest)
Then the authentication is not allowed.

BINDF2_DISABLEAUTOCOOKIEHANDLING

Do not automatically add cookie headers to requests, and do not automatically add returned cookies to the cookie database. Setting this flag adds the WinInet flag INTERNET_FLAG_NO_COOKIES on the current moniker binding. You can still set cookies manually on the request, and read them from the response.

BINDF2_READ_DATA_GREATER_THAN_4GB

Enable file downloads of sizes larger than 4 GB. If you do not set this flag, files that are larger than that size are interrupted at the 4 GB boundary, and IInternetProtocol::Read returns S_FALSE. To avoid buffer overflow in legacy consumers, progress for downloads larger than 4 GB is sent to IInternetProtocolSink::ReportProgress with the BINDSTATUS_64BIT_PROGRESS flag. Also, streaming data beyond the 4 GB boundary is not supported; instead, all data is written directly to disk.

BINDF2_DISABLE_HTTP_REDIRECT_XSECURITYID

Do not follow HTTP redirects unless the target SID matches the SID of the initial URL. For more information, see CompareSecurityIds.

BINDF2_SETDOWNLOADMODE

Internet Explorer 9. Resume an interrupted download. Return the path to the partially downloaded cache file from the IInternetBindInfo::GetBindString method when WinInet requests BINDSTRING_DOWNLOADPATH.

BINDF2_DISABLE_HTTP_REDIRECT_CACHING

Internet Explorer 9. Set to avoid using the redirect cache. Urlmon caches redirects for all applications to save a server round trip. In cases where WinInet reaches a redirection limit because of internal caching of redirects, Urlmon sets this flag when retrying the failed redirect. WinInet applications can get the same behavior by setting INTERNET_OPTION_ENABLE_REDIRECT_CACHE_READ to TRUE with InternetSetOption.

BINDF2_RESERVED_A