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

HRESULT HlinkCreateBrowseContext(

    IUnknown *

punkOuter,        //Controlling unknown for possible aggregation             
                                                                                           

    REFIID riid,                //Interface ID to return on the new browse context         
                                                                                           

    void **ppv                  //Receives the requested interfaceÆs pointer               
                                                                                           

   );                                                                                      
                                                                                           

punkOuter

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

riid

[in] Identifies the interface to return on the new browse context. Typically IID_IHlinkBrowseContext, although it must be IID_IUnknown when punkOuter is non-NULL so that the aggregator can retrieve the new browse contextÆs inner IUnknown for future delegation of QueryInterface. See the COM aggregation documentation for details.

ppv

[out] Location to return the riid interface.

Return Values

S_OK

The browse context was created and the interface pointer retrieved.

Remarks

This helper API is identical to calling

coCreateInstance(CLSID_StdHlinkBrowseContext, punkOuter,

    CLSCTX_SERVER, riid, ppv).

 

IHlinkBrowseContext, IHlinkFrame::GetBrowseContext, IHlinkTarget::GetBrowseContext