HlinkCreateBrowseContext Function

---

Creates an empty, default instance of the system browse context object.

Syntax

HRESULT HlinkCreateBrowseContext(
    IUnknown *piunkOuter,  
    REFIID riid,        
    void **ppvObj       
);

Parameters

piunkOuter

[in] Address of the controlling IUnknown interface for the new browse context. This is typically NULL, in which case the new browse context is not aggregated. This interface must be derived from IUnknown.

riid

[in] Used to identify the interface to return on the new browse context. This is typically IID_IHlinkBrowseContext, although it must be IID_IUnknown when piunkOuter is non-NULL so that the aggregator can retrieve the new browse context's inner IUnknown for future delegation of QueryInterface.

ppvObj

[out] Location to return the riid interface.

Return Value

Returns S_OK if the browse context was created and the interface pointer retrieved.

Example

This function is identical to calling the following:

coCreateInstance(CLSID_StdHlinkBrowseContext, piunkOuter, 
CLSCTX_SERVER, riid, ppv)

Function Information

Windows NT	Use version 4.0.
Windows	Use Windows 95 and later.
Header	Hlink.h
Import Library	Hlink.lib
Minimum availability	Internet Explorer 3.0

See Also

IHlinkBrowseContext, IHlinkFrame::GetBrowseContext, IHlinkTarget::GetBrowseContext