INewShortcutHookA
COM公式ドキュメント
新しいインターネットショートカットを作成するためのメソッドを公開します。(ANSI)
解説(Remarks)
通常、INewShortcutHook を実装する必要はありません。これはインターネットショートカット用にシェルによって実装されます。
INewShortcutHook は、新しいインターネットショートカットを作成するときに使用します。このインターフェイスが提供するメソッドは、利便性のために用意されています。
INewShortcutHook は IUnknown から派生しています。ここに示すメソッドは INewShortcutHook に固有のものです。
shlobj.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI 版または Unicode 版を自動的に選択するエイリアスとして INewShortcutHook を定義します。エンコーディング中立のエイリアスの使用とエンコーディング中立でないコードを混在させると、不一致が生じ、コンパイルエラーや実行時エラーを引き起こす可能性があります。詳細については、関数プロトタイプの規約を参照してください。
メソッド 6
vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。
ショートカットオブジェクトの参照先を設定します。(ANSI)
| pcszReferent | LPSTR | in | 未定(TBD) |
| hwnd | HWND | inoptional | 未定(TBD) |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
インターネットショートカットオブジェクトの場合、このメソッドは IUniformResourceLocator::SetURL と同じです。
ショートカットオブジェクトの参照先を取得します。(ANSI)
| pszReferent | LPSTR | out | 参照先を受け取る文字列へのポインターです。 |
| cchReferent | INT | in | pszReferent のバッファーのサイズ(文字数)です。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
解説(Remarks)
インターネットショートカットオブジェクトの場合、このメソッドは IUniformResourceLocator::GetURL と同じです。
ショートカットオブジェクトのフォルダー名を設定します。(ANSI)
| pcszFolder | LPSTR | in | 未定(TBD) - pszFolder [in]型: PCTSTR フォルダー名を含む文字列へのポインターです。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
ショートカットオブジェクトのフォルダー名を取得します。(ANSI)
| pszFolder | LPSTR | out | フォルダー名を受け取る文字バッファーのアドレスです。 |
| cchFolder | INT | in | pszFolder のバッファーのサイズ(文字数)です。 |
戻り値
ショートカットオブジェクトのファイル名を、拡張子を除いて取得します。(ANSI)
| pszName | LPSTR | out | 名前を受け取る文字列へのポインターです。 |
| cchName | INT | in | pszName のバッファーのサイズ(文字数)です。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
ショートカットオブジェクトのファイル名拡張子を取得します。(ANSI)
| pszExtension | LPSTR | out | 拡張子を受け取る文字列へのポインターです。 |
| cchExtension | INT | in | pszExtension のバッファーのサイズ(文字数)です。 |
戻り値
型: HRESULT
このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
HSP用 COM定義
#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"。
#define global IID_INewShortcutHookA "{000214E1-0000-0000-C000-000000000046}" #usecom global INewShortcutHookA IID_INewShortcutHookA "{}" #comfunc global INewShortcutHookA_SetReferent 3 str,sptr #comfunc global INewShortcutHookA_GetReferent 4 var,int #comfunc global INewShortcutHookA_SetFolder 5 str #comfunc global INewShortcutHookA_GetFolder 6 var,int #comfunc global INewShortcutHookA_GetName 7 var,int #comfunc global INewShortcutHookA_GetExtension 8 var,int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_INewShortcutHookA "{000214E1-0000-0000-C000-000000000046}" #usecom global INewShortcutHookA IID_INewShortcutHookA "{}" #comfunc global INewShortcutHookA_SetReferent 3 str,sptr #comfunc global INewShortcutHookA_GetReferent 4 sptr,int #comfunc global INewShortcutHookA_SetFolder 5 str #comfunc global INewShortcutHookA_GetFolder 6 sptr,int #comfunc global INewShortcutHookA_GetName 7 sptr,int #comfunc global INewShortcutHookA_GetExtension 8 sptr,int ; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。 ; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。 ; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。 ; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。