BINDF enumeration

Contains the values that determine how a resource is bound to a moniker.

Syntax

typedef enum  { 
  BINDF_ASYNCHRONOUS              = 0x00000001,
  BINDF_ASYNCSTORAGE              = 0x00000002,
  BINDF_NOPROGRESSIVERENDERING    = 0x00000004,
  BINDF_OFFLINEOPERATION          = 0x00000008,
  BINDF_GETNEWESTVERSION          = 0x00000010,
  BINDF_NOWRITECACHE              = 0x00000020,
  BINDF_NEEDFILE                  = 0x00000040,
  BINDF_PULLDATA                  = 0x00000080,
  BINDF_IGNORESECURITYPROBLEM     = 0x00000100,
  BINDF_RESYNCHRONIZE             = 0x00000200,
  BINDF_HYPERLINK                 = 0x00000400,
  BINDF_NO_UI                     = 0x00000800,
  BINDF_SILENTOPERATION           = 0x00001000,
  BINDF_PRAGMA_NO_CACHE           = 0x00002000,
  BINDF_GETCLASSOBJECT            = 0x00004000,
  BINDF_RESERVED_1                = 0x00008000,
  BINDF_FREE_THREADED             = 0x00010000,
  BINDF_DIRECT_READ               = 0x00020000,
  BINDF_FORMS_SUBMIT              = 0x00040000,
  BINDF_GETFROMCACHE_IF_NET_FAIL  = 0x00080000,
  BINDF_FROMURLMON                = 0x00100000,
  BINDF_FWD_BACK                  = 0x00200000,
  BINDF_PREFERDEFAULTHANDLER      = 0x00400000,
  BINDF_ENFORCERESTRICTED         = 0x00800000
} BINDF;

Constants

  • BINDF_ASYNCHRONOUS
    Value that indicates that the moniker will return immediately from a call to the IMoniker::BindToStorage method or the IMoniker::BindToObject method. The actual result of the bind to an object or the bind to storage returns asynchronously. The client application is notified by a call to the IBindStatusCallback::OnDataAvailable method or the IBindStatusCallback::OnObjectAvailable method. If the client does not specify this flag, the bind operation is synchronous, and the client receives no data from the bind operation until the IMoniker::BindToStorage call or the IMoniker::BindToObject call returns.

  • BINDF_ASYNCSTORAGE
    Value that indicates that the client application calling the IMoniker::BindToStorage method specifies that the storage objects and stream objects returned from the IBindStatusCallback::OnDataAvailable method return E_PENDING when the objects reference data that is not yet available through the IStream::Read method, instead of blocking until the data becomes available. This flag applies only to BINDF_ASYNCHRONOUS operations.

    Note Asynchronous stream objects return E_PENDING while data is still downloading and return S_FALSE for the end of the file.

  • BINDF_NOPROGRESSIVERENDERING
    Value that indicates that progressive rendering is not be allowed.

  • BINDF_OFFLINEOPERATION
    Value that indicates that the moniker is bound to the cached version of the resource.

  • BINDF_GETNEWESTVERSION
    Value that indicates that the bind operation retrieves the newest version of the data or object available. In URL monikers, this flag maps to the WinInet flag, INTERNET_FLAG_RELOAD, which forces a download of the requested resource.

  • BINDF_NOWRITECACHE
    Value that indicates that the bind operation does not store retrieved data in the disk cache. The client must specify BINDF_PULLDATA to turn off the cache file generation when the IMoniker::BindToStorage method is called.

  • BINDF_NEEDFILE
    Value that indicates that the downloaded resource must be saved in the cache or a local file.

  • BINDF_PULLDATA
    Value that indicates that the asynchronous moniker enables the client of the IMoniker::BindToStorage method to drive the bind operation by pulling the data, instead of using the moniker to drive the operation by pushing the data to the client. When this flag is specified, new data is read or downloaded after the client finishes downloading all data that is currently available. This means data is only downloaded for the client after the client calls an IStream::Read operation that blocks or returns E_PENDING. When this flag is specified, the client must read all the data it can, even data that is not necessarily available yet. When this flag is not specified, the moniker continues downloading data and calls the client with IBindStatusCallback::OnDataAvailable whenever new data is available. This flag applies only to BINDF_ASYNCHRONOUS bind operations.

  • BINDF_IGNORESECURITYPROBLEM
    Value that indicates that security problems related to bad certificates and redirects between HTTP and HTTPS servers should be ignored. For URL monikers, this flag corresponds to the following WinInet flags: INTERNET_FLAG_IGNORE_CERT_CN_INVALID, INTERNET_FLAG_IGNORE_CERT_DATE_INVALID, INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTP, and INTERNET_FLAG_IGNORE_REDIRECT_TO_HTTPS.

Security Warning: Using this value incorrectly can compromise the security of your application. If you implement the IBindStatusCallback::GetBindInfo method to ignore security problems with certificates and redirection, users may be susceptible to unwanted information disclosure. You should not implement IBindStatusCallback::GetBindInfo with a return value of BINDF_IGNORESECURITYPROBLEM because it prevents Internet Explorer from notifying users of security concerns. For more information, see Security Considerations: URL Monikers.

  • BINDF_RESYNCHRONIZE
    Value that indicates that the resource should be resynchronized. For URL monikers, this flag maps to the WinInet flag, INTERNET_FLAG_RESYNCHRONIZE, which reloads an HTTP resource if the resource has been modified since the last time it was downloaded. All FTP and Gopher resources are reloaded.

  • BINDF_HYPERLINK
    Value that indicates that hyperlinks are allowed.

  • BINDF_NO_UI
    Value that indicates that the bind operation will not display any user interfaces.

  • BINDF_SILENTOPERATION
    Value that indicates the bind operation will be completed silently. No user interface or user notification will occur.

  • BINDF_PRAGMA_NO_CACHE
    Value that indicates that the resource will not be stored in the Internet cache.

  • BINDF_GETCLASSOBJECT
    Value that indicates that the class object will be retrieved. Typically the class instance is retrieved.

  • BINDF_RESERVED_1
    Reserved.

  • BINDF_FREE_THREADED
    Reserved.

  • BINDF_DIRECT_READ
    Value that indicates that the client application does not have to know the exact size of the data available, so the information is read directly from the source.

  • BINDF_FORMS_SUBMIT
    Value that indicates that this transaction is handled as a forms submittal.

  • BINDF_GETFROMCACHE_IF_NET_FAIL
    Value that indicates the resource is retrieved from the cache if the attempt to download the resource from the network fails.

  • BINDF_FROMURLMON
    Value that indicates the binding is from a URL moniker. This value was added for Internet Explorer 5.

  • BINDF_FWD_BACK
    Value that indicates that the moniker will bind to the copy of the resource that is currently in the Internet cache. If the requested item is not found in the Internet cache, the system will attempt to locate the resource on the network. This value maps to the Win32 Internet API flag, INTERNET_FLAG_USE_CACHED_COPY.

  • BINDF_PREFERDEFAULTHANDLER
    Value that indicates that the moniker client will specify that Urlmon.dll should look for and use the default system protocol first, instead of searching for temporary or permanent namespace handlers before it uses the default registered handler for particular protocols.

  • BINDF_ENFORCERESTRICTED
    Value that indicates that this transaction will be treated as taking place in the Restricted Sites Zone. For URL monikers, this flag maps to the Win32 Internet API flag, INTERNET_FLAG_RESTRICTED_ZONE.

Remarks

These values are passed to the Urlmon.dll from the client application's implementation of the IBindStatusCallback::GetBindInfo method.

Note The gopher protocol is turned off by default in Microsoft Internet Explorer 6 for Windows XP Service Pack 2 (SP2). The protocol has been removed from WinInet in Windows Internet Explorer 7.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows 2000 Server

Product

Internet Explorer 3.0

Header

Urlmon.h

See also

Reference

IBindStatusCallback::OnDataAvailable

IBindStatusCallback::OnObjectAvailable

IBindStatusCallback::OnStartBinding