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

IShellUIHelper3

COMIDispatch (デュアル)
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IID528df2ec-d419-40bc-9b6d-dcdbf9c1b25d継承元IShellUIHelper2呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl36

メソッド 13

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 36 HRESULT AddService(LPWSTR URL)
URLLPWSTRin追加するサービス(アクセラレーター)記述の URL を指定する。
vtbl 37 HRESULT IsServiceInstalled(LPWSTR URL, LPWSTR Verb, DWORD* pdwResult)
URLLPWSTRinインストール状態を調べるサービスの URL を指定する。
VerbLPWSTRin対象とするサービスの動詞(操作)を指定する。
pdwResultDWORD*outサービスのインストール状態を示す結果値を受け取る DWORD へのポインタである。
vtbl 38 HRESULT InPrivateFilteringEnabled(VARIANT_BOOL* pfEnabled)
pfEnabledVARIANT_BOOL*outInPrivate フィルター処理が有効かどうかを受け取る VARIANT_BOOL へのポインタである。
vtbl 39 HRESULT AddToFavoritesBar(LPWSTR URL, LPWSTR Title, VARIANT* Type)
URLLPWSTRinお気に入りバーに追加する項目の URL を指定する。
TitleLPWSTRinお気に入りバーに表示するタイトルを指定する。
TypeVARIANT*in追加する項目の種別を保持する VARIANT へのポインタである。
vtbl 40 HRESULT BuildNewTabPage()
vtbl 41 HRESULT SetRecentlyClosedVisible(VARIANT_BOOL fVisible)
fVisibleVARIANT_BOOLin最近閉じたタブの一覧を表示するかどうかを示す VARIANT_BOOL を指定する。
vtbl 42 HRESULT SetActivitiesVisible(VARIANT_BOOL fVisible)
fVisibleVARIANT_BOOLinアクティビティ(アクセラレーター)を表示するかどうかを示す VARIANT_BOOL を指定する。
vtbl 43 HRESULT ContentDiscoveryReset()
vtbl 44 HRESULT IsSuggestedSitesEnabled(VARIANT_BOOL* pfEnabled)
pfEnabledVARIANT_BOOL*outおすすめサイト機能が有効かどうかを受け取る VARIANT_BOOL へのポインタである。
vtbl 45 HRESULT EnableSuggestedSites(VARIANT_BOOL fEnable)
fEnableVARIANT_BOOLinおすすめサイト機能を有効にするかどうかを示す VARIANT_BOOL を指定する。
vtbl 46 HRESULT NavigateToSuggestedSites(LPWSTR bstrRelativeUrl)
bstrRelativeUrlLPWSTRinおすすめサイトサービスへの相対 URL を指定する。
vtbl 47 HRESULT ShowTabsHelp()
vtbl 48 HRESULT ShowInPrivateHelp()

HSP用 COM定義

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

出力引数: 
#define global IID_IShellUIHelper3 "{528DF2EC-D419-40BC-9B6D-DCDBF9C1B25D}"
#usecom global IShellUIHelper3 IID_IShellUIHelper3 "{64AB4BB7-111E-11D1-8F79-00C04FC2FBE1}"
#comfunc global IShellUIHelper3_AddService                 36 wstr
#comfunc global IShellUIHelper3_IsServiceInstalled         37 wstr,wstr,var
#comfunc global IShellUIHelper3_InPrivateFilteringEnabled  38 var
#comfunc global IShellUIHelper3_AddToFavoritesBar          39 wstr,wstr,var
#comfunc global IShellUIHelper3_BuildNewTabPage            40
#comfunc global IShellUIHelper3_SetRecentlyClosedVisible   41 int
#comfunc global IShellUIHelper3_SetActivitiesVisible       42 int
#comfunc global IShellUIHelper3_ContentDiscoveryReset      43
#comfunc global IShellUIHelper3_IsSuggestedSitesEnabled    44 var
#comfunc global IShellUIHelper3_EnableSuggestedSites       45 int
#comfunc global IShellUIHelper3_NavigateToSuggestedSites   46 wstr
#comfunc global IShellUIHelper3_ShowTabsHelp               47
#comfunc global IShellUIHelper3_ShowInPrivateHelp          48
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。