Win32 API 日本語リファレンス
ホームUI.Shell › IHlink

IHlink

COM
IID79eac9c3-baf9-11ce-8c82-00aa004ba90b継承元IUnknown自前メソッド開始 vtbl3

メソッド 14

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT SetHlinkSite(IHlinkSite* pihlSite, DWORD dwSiteData)
pihlSiteIHlinkSite*inこのハイパーリンクに関連付けるサイトを表す IHlinkSite インターフェイスへのポインタである。
dwSiteDataDWORDinサイトがこのハイパーリンクを識別するために用いるサイト固有のデータを指定する。
vtbl 4 HRESULT GetHlinkSite(IHlinkSite** ppihlSite, DWORD* pdwSiteData)
ppihlSiteIHlinkSite**out関連付けられたサイトを表す IHlinkSite インターフェイスを受け取るポインタである。
pdwSiteDataDWORD*outサイトに関連付けられたサイト固有のデータを受け取る変数へのポインタである。
vtbl 5 HRESULT SetMonikerReference(DWORD grfHLSETF, IMoniker* pimkTarget, LPWSTR pwzLocation)
grfHLSETFDWORDinターゲットと位置のいずれを設定するかを示す HLSETF フラグを指定する。
pimkTargetIMoniker*inハイパーリンクのターゲットを表すモニカ(IMoniker)へのポインタである。
pwzLocationLPWSTRinターゲット内の位置(アンカー)を示す文字列を指定する。位置が不要な場合は NULL を指定できる。
vtbl 6 HRESULT GetMonikerReference(DWORD dwWhichRef, IMoniker** ppimkTarget, LPWSTR* ppwzLocation)
dwWhichRefDWORDin絶対参照と相対参照のいずれを取得するかを示す値を指定する。
ppimkTargetIMoniker**outoptionalハイパーリンクのターゲットを表すモニカ(IMoniker)を受け取るポインタである。
ppwzLocationLPWSTR*outoptionalターゲット内の位置文字列を受け取るポインタである。呼び出し側が CoTaskMemFree で解放する。
vtbl 7 HRESULT SetStringReference(DWORD grfHLSETF, LPWSTR pwzTarget, LPWSTR pwzLocation)
grfHLSETFDWORDinターゲットと位置のいずれを設定するかを示す HLSETF フラグを指定する。
pwzTargetLPWSTRinハイパーリンクのターゲットを示す文字列を指定する。
pwzLocationLPWSTRinターゲット内の位置(アンカー)を示す文字列を指定する。位置が不要な場合は NULL を指定できる。
vtbl 8 HRESULT GetStringReference(DWORD dwWhichRef, LPWSTR* ppwzTarget, LPWSTR* ppwzLocation)
dwWhichRefDWORDin絶対参照と相対参照のいずれを取得するかを示す値を指定する。
ppwzTargetLPWSTR*outoptionalハイパーリンクのターゲット文字列を受け取るポインタである。呼び出し側が CoTaskMemFree で解放する。
ppwzLocationLPWSTR*outoptionalターゲット内の位置文字列を受け取るポインタである。呼び出し側が CoTaskMemFree で解放する。
vtbl 9 HRESULT SetFriendlyName(LPWSTR pwzFriendlyName)
pwzFriendlyNameLPWSTRinハイパーリンクに設定する表示用のフレンドリ名を指定する。
vtbl 10 HRESULT GetFriendlyName(DWORD grfHLFNAMEF, LPWSTR* ppwzFriendlyName)
grfHLFNAMEFDWORDinフレンドリ名の取得方法を制御する HLFNAMEF フラグを指定する。
ppwzFriendlyNameLPWSTR*outハイパーリンクのフレンドリ名文字列を受け取るポインタである。呼び出し側が CoTaskMemFree で解放する。
vtbl 11 HRESULT SetTargetFrameName(LPWSTR pwzTargetFrameName)
pwzTargetFrameNameLPWSTRinナビゲート先となるターゲットフレームの名前を指定する。
vtbl 12 HRESULT GetTargetFrameName(LPWSTR* ppwzTargetFrameName)
ppwzTargetFrameNameLPWSTR*outターゲットフレームの名前文字列を受け取るポインタである。呼び出し側が CoTaskMemFree で解放する。
vtbl 13 HRESULT GetMiscStatus(DWORD* pdwStatus)
pdwStatusDWORD*outハイパーリンクのその他の状態を示すフラグを受け取る変数へのポインタである。
vtbl 14 HRESULT Navigate(DWORD grfHLNF, IBindCtx* pibc, IBindStatusCallback* pibsc, IHlinkBrowseContext* pihlbc)
grfHLNFDWORDinナビゲーションの動作を制御する HLNF フラグを指定する。
pibcIBindCtx*inナビゲーションに使用するバインドコンテキスト(IBindCtx)へのポインタである。
pibscIBindStatusCallback*inバインドの進捗通知を受け取る IBindStatusCallback へのポインタである。不要な場合は NULL を指定できる。
pihlbcIHlinkBrowseContext*inナビゲーションのコンテキストとなる IHlinkBrowseContext へのポインタである。不要な場合は NULL を指定できる。
vtbl 15 HRESULT SetAdditionalParams(LPWSTR pwzAdditionalParams)
pwzAdditionalParamsLPWSTRinハイパーリンクに設定する追加パラメータ文字列を指定する。
vtbl 16 HRESULT GetAdditionalParams(LPWSTR* ppwzAdditionalParams)
ppwzAdditionalParamsLPWSTR*outハイパーリンクの追加パラメータ文字列を受け取るポインタである。呼び出し側が CoTaskMemFree で解放する。

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"

出力引数:
#define global IID_IHlink "{79EAC9C3-BAF9-11CE-8C82-00AA004BA90B}"
#usecom global IHlink IID_IHlink "{}"
#comfunc global IHlink_SetHlinkSite         3 sptr,int
#comfunc global IHlink_GetHlinkSite         4 sptr,var
#comfunc global IHlink_SetMonikerReference  5 int,sptr,wstr
#comfunc global IHlink_GetMonikerReference  6 int,sptr,var
#comfunc global IHlink_SetStringReference   7 int,wstr,wstr
#comfunc global IHlink_GetStringReference   8 int,var,var
#comfunc global IHlink_SetFriendlyName      9 wstr
#comfunc global IHlink_GetFriendlyName      10 int,var
#comfunc global IHlink_SetTargetFrameName   11 wstr
#comfunc global IHlink_GetTargetFrameName   12 var
#comfunc global IHlink_GetMiscStatus        13 var
#comfunc global IHlink_Navigate             14 int,sptr,sptr,sptr
#comfunc global IHlink_SetAdditionalParams  15 wstr
#comfunc global IHlink_GetAdditionalParams  16 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。