The client of an asynchronous moniker provides the BINDINFO structure and returns it to the asynchronous moniker when the moniker calls the clientÆs IBindStatusCallback::GetBindInfo method. The BINDINFO structure provides additional information for the requested binding operation. The meaning of this structure is specific to the type of asynchronous moniker. The technical specification provided here describes the meaning of the structure when used for URL monikers.

typedef struct tagBINDINFO {

    ULONG        cbSize;

    LPWSTR       szExtraInfo;

    STGMEDIUM    stgmedData;

    DWORD        grfBindInfoF;

    DWORD        dwBindVerb;

    LPWSTR       szCustomVerb;

    DWORD        cbStgmedData;

} BINDINFO;

 

cbSize

Size of the structure, in bytes.

szExtraInfo

The 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 CoMemAlloc. The URL Moniker will free 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

A 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.

See Also

BINDINFOF, BINDVERB, IBindStatusCallback::GetBindInfo