Contents Index Topic Contents | ||
Previous Topic: Enumerated Types Next Topic: BINDINFOF |
BINDF
typedef { 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_FREE_THREADED = 0x00010000, BINDF_DIRECT_READ = 0x00020000, BINDF_FORMS_SUBMIT = 0x00040000, BINDF_GETFROMCACHE_IF_NET_FAIL = 0x00080000 } BINDF;Values from the BINDF enumeration are returned to the moniker from the client's IBindStatusCallback::GetBindInfo method. These values specify the type of binding the client wants from the moniker.
- BINDF_ASYNCHRONOUS
- Moniker should return immediately from IMoniker::BindToStorage or IMoniker::BindToObject. The actual result of the object bind or the data backing the storage arrives asynchronously. The client is notified through calls to its IBindStatusCallback::OnDataAvailable or IBindStatusCallback::OnObjectAvailable method. 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::BindToXxx call returns.
- BINDF_ASYNCSTORAGE
- Client of the IMoniker::BindToStorage method prefers that the storage and stream objects returned in IBindStatusCallback::OnDataAvailable return 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
- Do not allow progressive rendering.
- BINDF_OFFLINEOPERATION
- Bind to a cached version of the resource.
- BINDF_GETNEWESTVERSION
- Bind operation should retrieve the newest version of the data/object possible. For URL monikers, this flag maps to the Win32 Internet API flag, INTERNET_FLAG_RELOAD, which forces a dowload of the requested resource.
- BINDF_NOWRITECACHE
- Bind operation should not store retrieved data in the disk cache.
- BINDF_NEEDFILE
- Downloaded resource must be saved in the cache.
- BINDF_PULLDATA
- Asynchronous moniker allows the client of IMoniker::BindToStorage to drive the bind operation by pulling the data, rather than having the moniker drive the operation by pushing the data to the client. Specifically, when this flag is specified, new data is only read/downloaded after the client finishes reading all data that is currently available. This means data is only downloaded for the client after the client does an IStream::Read operation 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::OnDataAvailable whenever new data is available. This flag applies only to BINDF_ASYNCHRONOUS bind operations.
- BINDF_IGNORESECURITYPROBLEM
- Ignore any security problems.
- BINDF_RESYNCHRONIZE
- Resynchronizes the resource. For URL monikers, this flag maps to the Win32 Internet API 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
- Allow hyperlinks.
- BINDF_NO_UI
- Do not display any user interfaces.
- BINDF_SILENTOPERATION
- Operate silently. No user interface or user notification should occur.
- BINDF_PRAGMA_NO_CACHE
- Do not store the resource in the cache.
- BINDF_FREE_THREADED
- Reserved for future use.
- BINDF_DIRECT_READ
- Client does not need to know the exact size of the data available, so the information is read directly from the source.
- BINDF_FORMS_SUBMIT
- Handle this transaction as a forms submittal.
- BINDF_GETFROMCACHE_IF_NET_FAIL
- Retrieve the resource from the cache if the attempt to download the resource from the network fails.
See also IBindStatusCallback::OnDataAvailable, IBindStatusCallback::OnObjectAvailable, IBindStatusCallback::OnStartBinding
Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.