HlinkClone function

[HlinkClone 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 a clone by calling IPersistStream::Save followed by a IPersistStream::Load.

Syntax

HRESULT HlinkClone(
   IHlink     *pihl,
   REFIID     riid,
   IHlinkSite *pihlsiteForClone,
   DWORD      dwSiteData,
   void       **ppvObj
);

Parameters

• pihl
  The address of the IHlink interface on the target hyperlink.

• riid
  The interface identifier.

• pihlsiteForClone
  The address of the IHlinkSite object for the clone.

• dwSiteData
  The additional site data for the clone.

• ppvObj
  An indirect pointer to the requested interface.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements