BINDINFO Structure

---

Contains additional information on the requested binding operation. The meaning of this structure is specific to the type of asynchronous moniker.

Syntax

typedef struct _tagBINDINFO {
    ULONG cbSize;
    LPWSTR szExtraInfo;
    STGMEDIUM stgmedData;
    DWORD grfBindInfoF;
    DWORD dwBindVerb;
    LPWSTR szCustomVerb;
    DWORD cbStgmedData;
    DWORD dwOptions;
    DWORD dwOptionsFlags;
    DWORD dwCodePage;
    SECURITY_ATTRIBUTES securityAttributes;
    IID iid;
    IUnknown *pUnk;
    DWORD dwReserved;
} BINDINFO;

Members

cbSize

Size of the structure, in bytes.

szExtraInfo

Behavior of this field is moniker-specific. For URL monikers, this string is appended to the URL when the bind operation is started. Like other OLE strings, this value is a Unicode string that the client should allocate using CoTaskMemAlloc. The URL moniker frees the memory later.

stgmedData

Data to be used in a PUT or POST operation specified by the dwBindVerb member.

grfBindInfoF

Flag from the BINDINFOF enumeration that determines the use of URL encoding during the binding operation. This member is specific to URL monikers.

dwBindVerb

Value from the BINDVERB enumeration specifying an action to be performed during the bind operation.

szCustomVerb

String specifying a protocol-specific custom action to be performed during the bind operation (only if dwBindVerb is set to BINDVERB_CUSTOM).

cbStgmedData

Size of the data provided in the stgmedData member.

dwOptions

Reserved. Must be set to zero.

dwOptionsFlags

Reserved. Must be set to zero.

dwCodePage

Unsigned long integer value that contains the code page used to perform the conversion. This can be one of the following values:

CP_ACP	ANSI code page
CP_MACCP	Macintosh code page
CP_OEMCP	OEM code page
CP_SYMBOL	Symbol code page (42)
CP_THREAD_ACP	Current thread's ANSI code page
CP_UTF7	Translate using UTF-7
CP_UTF8	Translate using UTF-8

securityAttributes

SECURITY_ATTRIBUTES structure that contains the descriptor for the object being bound to and indicates whether the handle retrieved by specifying this structure is inheritable.

iid

Interface identifier of the IUnknown interface referred to by pUnk.

pUnk

Address of the IUnknown interface.

dwReserved

Reserved. Must be set to zero.

Remarks

The size of this structure has changed with the release of Microsoft® Internet Explorer 4.0. Developers must write code that checks the size of the BINDINFO structure that is passed into their implementation of this method before writing to members of the structure. For more information, see Handling BINDINFO Structures in URL Monikers Overview.

Structure Information

Windows NT	Use version 4.0
Windows	Use Windows 95 and later
Header	Urlmon.h
Minimum availability	Internet Explorer 3.0

Windows CE

Windows CE	Use version 2.12 and later
Minimum availability	Internet Explorer 4.0

See Also

IBindStatusCallback::GetBindInfo