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

IShellUIHelper2

COMIDispatch (デュアル)
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IIDa7fe6eda-1932-4281-b881-87b31b8bc52c継承元IShellUIHelper呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl20

メソッド 16

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

vtbl 20 HRESULT AddSearchProvider(LPWSTR URL)
URLLPWSTRin追加する検索プロバイダー記述(OpenSearch)の URL を指定する。
vtbl 21 HRESULT RunOnceShown()
vtbl 22 HRESULT SkipRunOnce()
vtbl 23 HRESULT CustomizeSettings(VARIANT_BOOL fSQM, VARIANT_BOOL fPhishing, LPWSTR bstrLocale)
fSQMVARIANT_BOOLinソフトウェア品質指標(SQM)への参加を有効にするかどうかを示す VARIANT_BOOL を指定する。
fPhishingVARIANT_BOOLinフィッシング/不審サイト フィルターを有効にするかどうかを示す VARIANT_BOOL を指定する。
bstrLocaleLPWSTRin適用するロケールを示す文字列を指定する。
vtbl 24 HRESULT SqmEnabled(VARIANT_BOOL* pfEnabled)
pfEnabledVARIANT_BOOL*outSQM への参加が有効かどうかを受け取る VARIANT_BOOL へのポインタである。
vtbl 25 HRESULT PhishingEnabled(VARIANT_BOOL* pfEnabled)
pfEnabledVARIANT_BOOL*outフィッシング フィルターが有効かどうかを受け取る VARIANT_BOOL へのポインタである。
vtbl 26 HRESULT BrandImageUri(LPWSTR* pbstrUri)
pbstrUriLPWSTR*outブランド画像の URI を表す文字列を受け取るポインタである。
vtbl 27 HRESULT SkipTabsWelcome()
vtbl 28 HRESULT DiagnoseConnection()
vtbl 29 HRESULT CustomizeClearType(VARIANT_BOOL fSet)
fSetVARIANT_BOOLinClearType を有効にするかどうかを示す VARIANT_BOOL を指定する。
vtbl 30 HRESULT IsSearchProviderInstalled(LPWSTR URL, DWORD* pdwResult)
URLLPWSTRinインストール状態を調べる検索プロバイダーの URL を指定する。
pdwResultDWORD*out検索プロバイダーのインストール状態を示す結果値を受け取る DWORD へのポインタである。
vtbl 31 HRESULT IsSearchMigrated(VARIANT_BOOL* pfMigrated)
pfMigratedVARIANT_BOOL*out検索設定が移行済みかどうかを受け取る VARIANT_BOOL へのポインタである。
vtbl 32 HRESULT DefaultSearchProvider(LPWSTR* pbstrName)
pbstrNameLPWSTR*out既定の検索プロバイダーの名前を表す文字列を受け取るポインタである。
vtbl 33 HRESULT RunOnceRequiredSettingsComplete(VARIANT_BOOL fComplete)
fCompleteVARIANT_BOOLin初回起動時の必須設定が完了したかどうかを示す VARIANT_BOOL を指定する。
vtbl 34 HRESULT RunOnceHasShown(VARIANT_BOOL* pfShown)
pfShownVARIANT_BOOL*out初回起動画面が既に表示されたかどうかを受け取る VARIANT_BOOL へのポインタである。
vtbl 35 HRESULT SearchGuideUrl(LPWSTR* pbstrUrl)
pbstrUrlLPWSTR*out検索ガイドの URL を表す文字列を受け取るポインタである。

HSP用 COM定義

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

出力引数: 
#define global IID_IShellUIHelper2 "{A7FE6EDA-1932-4281-B881-87B31B8BC52C}"
#usecom global IShellUIHelper2 IID_IShellUIHelper2 "{64AB4BB7-111E-11D1-8F79-00C04FC2FBE1}"
#comfunc global IShellUIHelper2_AddSearchProvider                20 wstr
#comfunc global IShellUIHelper2_RunOnceShown                     21
#comfunc global IShellUIHelper2_SkipRunOnce                      22
#comfunc global IShellUIHelper2_CustomizeSettings                23 int,int,wstr
#comfunc global IShellUIHelper2_SqmEnabled                       24 var
#comfunc global IShellUIHelper2_PhishingEnabled                  25 var
#comfunc global IShellUIHelper2_BrandImageUri                    26 var
#comfunc global IShellUIHelper2_SkipTabsWelcome                  27
#comfunc global IShellUIHelper2_DiagnoseConnection               28
#comfunc global IShellUIHelper2_CustomizeClearType               29 int
#comfunc global IShellUIHelper2_IsSearchProviderInstalled        30 wstr,var
#comfunc global IShellUIHelper2_IsSearchMigrated                 31 var
#comfunc global IShellUIHelper2_DefaultSearchProvider            32 var
#comfunc global IShellUIHelper2_RunOnceRequiredSettingsComplete  33 int
#comfunc global IShellUIHelper2_RunOnceHasShown                  34 var
#comfunc global IShellUIHelper2_SearchGuideUrl                   35 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。