IHlinkTarget  Interface

IID_IHlinkTarget

{79EAC9C4-BAF9-11CE-8C82-00AA004BA90B}

This interface is implemented by a hyperlink target to provide hyperlink references to the target's contents.
 

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IHlinkTarget Methods

Description

SetBrowseContext

Establishes the current browse context for the hyperlink target.

GetBrowseContext

Retrieves the browse context in which the hyperlink target is currently running.

Navigate

Navigates to and shows the specified location within the object/document, if the specified location is not visible.

GetMoniker

Returns a moniker to the hyperlink target object.

GetFriendlyName

Retrieves a display name for the given hyperlink location within the target.

SetBrowseContext

FUNCTION IHlinkTarget_SetBrowseContext ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pihlbc AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[3] USING IHlinkTarget_SetBrowseContext (pthis, pihlbc) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

GetBrowseContext

FUNCTION IHlinkTarget_GetBrowseContext ( _
  BYVAL pthis AS DWORD PTR _
, BYREF ppihlbc AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING IHlinkTarget_GetBrowseContext (pthis, ppihlbc) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION

Navigate

FUNCTION IHlinkTarget_Navigate ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL grfHLNF AS DWORD _
, BYVAL strJumpLocation AS STRING _
  ) AS LONG

  LOCAL HRESULT AS LONG

  strJumpLocation = UCODE$(strJumpLocation) & $NUL

  CALL DWORD @@pthis[5] USING IHlinkTarget_Navigate (pthis, grfHLNF, strJumpLocation) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

GetMoniker

FUNCTION IHlinkTarget_GetMoniker ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL strLocation AS STRING _
, BYVAL dwAssign AS DWORD _
, BYREF ppimkLocation AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG

  strLocation = UCODE$(strLocation) & $NUL

  CALL DWORD @@pthis[6] USING IHlinkTarget_GetMoniker (pthis, strLocation, dwAssign, ppimkLocation) TO HRESULT

  FUNCTION = HRESULT

END FUNCTION
 

GetFriendlyName

FUNCTION Proto_IHlinkTarget_GetFriendlyName ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pwzLocation AS DWORD _
, BYREF ppwzFriendlyName AS DWORD _
  ) AS LONG
 

FUNCTION IHlinkTarget_GetFriendlyName ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL strLocation AS STRING _
, BYREF strFriendlyName AS STRING _
  ) AS LONG

  strFriendlyName = ""

  LOCAL HRESULT AS LONG

  LOCAL ppwzFriendlyName AS DWORD

  strLocation = UCODE$(strLocation) & $NUL

  CALL DWORD @@pthis[6] USING Proto_IHlinkTarget_GetFriendlyName (pthis, STRPTR(strLocation), ppwzFriendlyName) TO HRESULT
  IF ISTRUE ppwzFriendlyName THEN
     bstrlen = lstrlenW(BYVAL ppwzFriendlyName)
     IF ISTRUE bstrlen THEN
        strFriendlyName = PEEK$(ppwzFriendlyName, bstrlen * 2)
        strFriendlyName = ACODE$(strFriendlyName)
     END IF
     CoTaskMemFree ppwzFriendlyName
  END IF
  FUNCTION = HRESULT

END FUNCTION