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
    Internet Explorer 9. Reserved. Do not use.

  • BINDF2_RESERVED_9
    Internet Explorer 9. Reserved. Do not use.

  • BINDF2_RESERVED_8
    Internet Explorer 9. Reserved. Do not use.

  • BINDF2_RESERVED_7
    Internet Explorer 9. Reserved. Do not use.

  • BINDF2_RESERVED_6
    Internet Explorer 9. Reserved. Do not use.

  • BINDF2_RESERVED_5
    Internet Explorer 9. Reserved. Do not use.

  • BINDF2_RESERVED_4
    Reserved. Do not use.

  • BINDF2_RESERVED_3
    Reserved. Do not use.

  • BINDF2_RESERVED_2
    Reserved. Do not use.

  • BINDF2_RESERVED_1
    Reserved. Do not use.

Remarks

The BINDF2 enumeration values are passed to Urlmon.dll from your application's implementation of the IBindStatusCallbackEx::GetBindInfoEx and IInternetBindInfoEx::GetBindInfoEx methods.

Requirements

Minimum supported client

Windows XP with SP2, Windows Vista

Minimum supported server

Windows Server 2008

Product

Internet Explorer 8

Header

Urlmon.h

IDL

Urlmon.idl

See also

Reference

OnDataAvailable

OnObjectAvailable

OnStartBinding