Contents Index Topic Contents
	Previous Topic: Functions Next Topic: HlinkCreateFromData

HlinkCreateBrowseContext

HRESULT HlinkCreateBrowseContext(
    IUnknown *piunkOuter,    //Controlling unknown for possible aggregation
    REFIID riid,        //Interface identifier to return on the new browse context
    void **ppvObj       //Receives the requested interface's pointer
   );

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

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

piunkOuter

[in] Address of the controlling IUnknown interface 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] Used to identify 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.

ppvObj

[out] Location to return the riid interface.

This helper function is identical to calling the following:

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

See also IHlinkBrowseContext, IHlinkFrame::GetBrowseContext, IHlinkTarget::GetBrowseContext

---

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