Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

A version of this page is also available for

4/8/2010

This enumeration contains the values that determine how a resource should be 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_RESERVED_3 = 0x00800000 } BINDF;

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_RESERVED_3 = 0x00800000
} BINDF;

Elements

BINDF_ASYNCHRONOUS: Value that indicates that the moniker should return immediately from IMoniker::BindToStorageor IMoniker::BindToObject. The actual result of the bind to an object or the bind to storage arrives asynchronously. The client is notified through calls to its IBindStatusCallback::OnDataAvailableor IBindStatusCallback::OnObjectAvailablemethod. If the client does not specify this flag, the bind operation will be synchronous and the client will not receive any data from the bind operation until the IMoniker::BindToStorageor IMoniker::BindToObjectcall returns.

BINDF_ASYNCSTORAGE: Value that indicates that the client application calling the IMoniker::BindToStoragemethod prefers that the storage and stream objects returned in IBindStatusCallback::OnDataAvailablereturn E_PENDING when they reference data not yet available through their read methods, rather than blocking until the data becomes available. This flag applies only to BINDF_ASYNCHRONOUS operations. Note that 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 should not be allowed.

BINDF_OFFLINEOPERATION: Value that indicates that the moniker should be bound to the cached version of the resource.

BINDF_GETNEWESTVERSION: Value that indicates that the bind operation should retrieve the newest version of the data/object possible. For URL monikers, this flag maps to the WinInet API flag, INTERNET_FLAG_RELOAD, which forces a download of the requested resource.

BINDF_NOWRITECACHE: Value that indicates that the bind operation should not store retrieved data in the disk cache. BINDF_PULLDATA must also be specified to turn off the cache file generation when using the IMoniker::BindToStoragemethod.

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 allows the client of IMoniker::BindToStorageto drive the bind operation by pulling the data, rather than having the moniker drive the operation by pushing the data to the client. When this flag is specified, new data is only read and downloaded after the client finishes downloading all data that is currently available. This means data is only downloaded for the client after the client does an IStream::Readoperation that blocks or returns E_PENDING. When the client specifies this flag, it must be sure to 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::OnDataAvailablewhenever 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.

BINDF_RESYNCHRONIZE: Value that indicates that the resource should be resynchronized. For URL monikers, this flag maps to the WinInet API flag, INTERNET_FLAG_RESYNCHRONIZE, which reloads an HTTP resource if the resource has been modified since the last time it was downloaded. All File Transfer Protocol (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 should not display any user interfaces.

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

BINDF_PRAGMA_NO_CACHE: Value that indicates that the resource should not be stored in the Internet cache.

BINDF_GETCLASSOBJECT: Value that indicates that the class object should be retrieved. Normally the class instance is retrieved.

BINDF_RESERVED_1: Reserved. Do not use.

BINDF_FREE_THREADED: Reserved for future use.

BINDF_DIRECT_READ: Value that indicates that the client application does not need 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 should be handled as a forms submittal.

BINDF_GETFROMCACHE_IF_NET_FAIL: Value that indicates that the resource should be retrieved from the cache if the attempt to download the resource from the network fails.

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

BINDF_FWD_BACK: Value that indicates that the moniker should 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 Microsoft® Win32® Internet API flag, INTERNET_FLAG_USE_CACHED_COPY.

BINDF_PREFERDEFAULTHANDLER: Urlmon.dll searches for temporary or permanent name space handlers before it uses the default registered handler for particular protocols. This value changes this behavior by allowing the moniker client to specify that Urlmon.dll should look for and use the default system protocol first.

BINDF_RESERVED_3: Reserved. Do not use.

Remarks

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

Requirements

Header	urlmon.h, urlmon.idl
Library	urlmon.lib
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Pocket PC 2000 and later, Smartphone 2002 and later



BINDF