BINDFBINDF*
*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


Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.