HlinkCreateBrowseContext function

[HlinkCreateBrowseContext may be altered or unavailable in subsequent versions of the operating system or product.]

Note  The Microsoft ActiveX Hyperlink API is deprecated in Windows Internet Explorer 8 and later, and ActiveX technology as a whole is unsupported in the Microsoft Edge browser in favor of standards-based web APIs. For more information, see Saying goodbye to ActiveX, VBScript, attachEvent... and Get ready for plug-in free browsing.

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

Syntax

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

Parameters

• piunkOuter [in]
  The address of the controlling IUnknown interface for the new browse context. This is typically NULL, and the new browse context is not aggregated. This interface must be derived from IUnknown.

• riid [in]
  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 inner IUnknown for delegation of QueryInterface.

• ppvObj [out]
  The location to return the riid interface.

Return value

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

Examples

This function is identical to the following call.

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

Requirements

See also

Reference

IHlinkBrowseContext

IHlinkFrame::GetBrowseContext

IHlinkTarget::GetBrowseContext