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 {
unsigned long 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 bind 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
BSTR 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
Value from the BINDINFO_OPTIONS enumeration specifying flags for the bind operation.
dwOptionsFlags
Additional Win32 Internet API flags. Must also set BINDINFO_OPTIONS_WININETFLAG in dwOptions.
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
Pointer to the IUnknown interface.
dwReserved
Reserved. Must be zero.
Remarks
The size of this structure 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.
Requirements
Minimum supported client |
Windows XP |
Minimum supported server |
Windows 2000 Server |
Product |
Internet Explorer 3.0 |
Header |
Urlmon.h |