Structures

Structures


This section contains the structures that are exposed by Urlmon.dll.
BINDINFO
PROTOCOLDATA
PROTOCOLFILTERDATA
ZONEATTRIBUTES

BINDINFO

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;

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

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
Double-word value that contains additional options.
dwOptionsFlags
Double-word value that contains the option flags.
dwCodePage
Double-word value that contains the code used to convert the URL.
securityAttributes
SECURITY_ATTRIBUTES structure that contains the descriptor for the object being bound to and specifies 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.

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. See Handling BINDINFO Structuress section in the Monikers, URLs, Security Zones, and Pluggable Protocols Overview for more information.

See also BINDINFOF, BINDVERB, IBindStatusCallback::GetBindInfo

PROTOCOLDATA

typedef struct _tagPROTOCOLDATA{
    DWORD grfFlags;
    DWORD dwState;
    LPVOID pData;
    ULONG cbData;
}  PROTOCOLDATA;

Contains state information about the protocol that is transparent to the transaction handler.

grfFlags
Double-word value that contains the flags.
dwState
Double-word value that contains the state of the protocol handler.
pData
Address of the data buffer.
cbData
Double-word value containing the size of the data buffer.

PROTOCOLFILTERDATA

typedef struct _tagPROTOCOLFILTERDATA {
    DWORD cbSize;
    IInternetProtocolSink *pProtocolSink;
    IInternetProtocol *pProtocol;
    IUnknown *pUnk;
    DWORD dwFilterFlags;
} PROTOCOLFILTERDATA;

Contains the IInternetProtocolSink and IInternetProtocol interfaces of the application calling a pluggable MIME filter.

cbSize
Unsigned long integer value containing the size of the structure.
pProtocolSink
Address of the application's implementation of IInternetProtocolSink.
pProtocol
Address of the application's implementation of IInternetProtocol.
pUnk
Address of the IUnknown interface.
dwFilterFlags
Reserved. Must be set to zero.

ZONEATTRIBUTES

typedef struct _ZONEATTRIBUTES {
    ULONG cbSize;
    WCHAR szDisplayName[MAX_PATH];
    WCHAR szDescription[MAX_ZONE_DESCRIPTION];
    WCHAR szIconPath[MAX_PATH];
    DWORD dwTemplateMinLevel;
    DWORD dwTemplateRecommended;
    DWORD dwTemplateCurrentLevel;
    DWORD dwFlags;
} ZONEATTRIBUTES, *LPZONEATTRIBUTES;

Contains the attributes of a particular zone.

cbSize
Unsigned long integer value that contains the size of the structure.
szDisplayName
Array of wide characters that contains the display name of the zone.
szDescription
Array of wide characters that contains the description of the zone.
szIconPath
Array of wide characters that contains the path to the icon associated with this zone.
dwTemplateMinLevel
Double-word value that contains the minimum template level.
dwTemplateRecommended
Double-word value that contains the recommended template level.
dwTemplateCurrentLevel
Double-word value that contains the current template level.
dwFlags
Double-word value that contains the flags associated with the specified zone. Can be one of the ZAFLAGS values.

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.