ホーム › UI.Shell › IShellDispatch2

IShellDispatch2

COMIDispatch (デュアル)

📘 Microsoft Learn (日本語) · English

✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。

IIDa4c6892c-3ba9-11d2-9dea-00c04fb16162継承元IShellDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl30

公式ドキュメント

IShellDispatch オブジェクトをさまざまな新機能で拡張します。

解説(Remarks)

IShellDispatch オブジェクトをさまざまな新機能で拡張します。

メモ

IShellDispatch2 は Shell オブジェクトを通じて実装され、アクセスされます。

Windows サービスについては、Services のドキュメントを参照してください。

メソッド 9

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

vtbl 30 HRESULT IsRestricted(LPWSTR Group, LPWSTR Restriction, INT* plRestrictValue)

レジストリからグループの制限設定を取得します。

Group	LPWSTR	in	ポリシーを照会するグループ名を指定する。
Restriction	LPWSTR	in	照会する制限(ポリシー)名を指定する。
plRestrictValue	INT*	out	指定したポリシーの制限値を受け取るポインタである。

vtbl 31 HRESULT ShellExecute(LPWSTR File, VARIANT vArgs, VARIANT vDir, VARIANT vOperation, VARIANT vShow)

指定したファイルに対して、指定した操作を実行します。

File	LPWSTR	in	実行または開く対象のファイル名やドキュメント名を指定する。
vArgs	VARIANT	in	実行ファイルに渡すコマンドライン引数を示す VARIANT を指定する。
vDir	VARIANT	in	作業ディレクトリを示す VARIANT を指定する。
vOperation	VARIANT	in	実行する動詞("open"、"edit"、"print" など)を示す VARIANT を指定する。
vShow	VARIANT	in	起動時のウィンドウ表示状態(SW_ 系の値)を示す VARIANT を指定する。

vtbl 32 HRESULT FindPrinter(LPWSTR name, LPWSTR location, LPWSTR model)

[プリンターの検索] ダイアログボックスを表示します。

name	LPWSTR	in	検索対象のプリンター名を指定する。
location	LPWSTR	in	検索対象のプリンターの場所を指定する。
model	LPWSTR	in	検索対象のプリンターのモデルを指定する。

vtbl 33 HRESULT GetSystemInformation(LPWSTR name, VARIANT* pv)

システム情報を取得します。

name	LPWSTR	in	取得するシステム情報の名前を指定する。
pv	VARIANT*	out	取得したシステム情報の値を受け取る VARIANT ポインタである。

vtbl 34 HRESULT ServiceStart(LPWSTR ServiceName, VARIANT Persistent, VARIANT* pSuccess)

指定した名前のサービスを開始します。

ServiceName	LPWSTR	in	開始するサービスの名前を指定する。
Persistent	VARIANT	in	サービスの開始状態を永続化するかどうかを示す VARIANT を指定する。
pSuccess	VARIANT*	out	サービス開始が成功したかどうかを示す結果を受け取る VARIANT ポインタである。

vtbl 35 HRESULT ServiceStop(LPWSTR ServiceName, VARIANT Persistent, VARIANT* pSuccess)

指定した名前のサービスを停止します。

ServiceName	LPWSTR	in	停止するサービスの名前を指定する。
Persistent	VARIANT	in	サービスの停止状態を永続化するかどうかを示す VARIANT を指定する。
pSuccess	VARIANT*	out	サービス停止が成功したかどうかを示す結果を受け取る VARIANT ポインタである。

vtbl 36 HRESULT IsServiceRunning(LPWSTR ServiceName, VARIANT* pRunning)

特定のサービスが実行中かどうかを示す値を返します。

ServiceName	LPWSTR	in	状態を照会するサービスの名前を指定する。
pRunning	VARIANT*	out	サービスが実行中かどうかを示す結果を受け取る VARIANT ポインタである。

vtbl 37 HRESULT CanStartStopService(LPWSTR ServiceName, VARIANT* pCanStartStop)

現在のユーザーが指定した名前のサービスを開始および停止できるかどうかを判定します。

ServiceName	LPWSTR	in	照会対象のサービスの名前を指定する。
pCanStartStop	VARIANT*	out	現在のユーザーがそのサービスを開始または停止できるかどうかを示す結果を受け取る VARIANT ポインタである。

vtbl 38 HRESULT ShowBrowserBar(LPWSTR bstrClsid, VARIANT bShow, VARIANT* pSuccess)

ブラウザーバーを表示します。

bstrClsid	LPWSTR	in	表示または非表示にするブラウザーバーの CLSID を文字列で指定する。
bShow	VARIANT	in	ブラウザーバーを表示するか非表示にするかを示す VARIANT を指定する。
pSuccess	VARIANT*	out	操作が成功したかどうかを示す結果を受け取る VARIANT ポインタである。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp)

HSP用 COM定義

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

出力引数:

#define global IID_IShellDispatch2 "{A4C6892C-3BA9-11D2-9DEA-00C04FB16162}"
#usecom global IShellDispatch2 IID_IShellDispatch2 "{}"
#comfunc global IShellDispatch2_IsRestricted          30 wstr,wstr,var
#comfunc global IShellDispatch2_ShellExecute          31 wstr,int,int,int,int
#comfunc global IShellDispatch2_FindPrinter           32 wstr,wstr,wstr
#comfunc global IShellDispatch2_GetSystemInformation  33 wstr,var
#comfunc global IShellDispatch2_ServiceStart          34 wstr,int,var
#comfunc global IShellDispatch2_ServiceStop           35 wstr,int,var
#comfunc global IShellDispatch2_IsServiceRunning      36 wstr,var
#comfunc global IShellDispatch2_CanStartStopService   37 wstr,var
#comfunc global IShellDispatch2_ShowBrowserBar        38 wstr,int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。#define global IID_IShellDispatch2 "{A4C6892C-3BA9-11D2-9DEA-00C04FB16162}"
#usecom global IShellDispatch2 IID_IShellDispatch2 "{}"
#comfunc global IShellDispatch2_IsRestricted          30 wstr,wstr,sptr
#comfunc global IShellDispatch2_ShellExecute          31 wstr,int,int,int,int
#comfunc global IShellDispatch2_FindPrinter           32 wstr,wstr,wstr
#comfunc global IShellDispatch2_GetSystemInformation  33 wstr,sptr
#comfunc global IShellDispatch2_ServiceStart          34 wstr,int,sptr
#comfunc global IShellDispatch2_ServiceStop           35 wstr,int,sptr
#comfunc global IShellDispatch2_IsServiceRunning      36 wstr,sptr
#comfunc global IShellDispatch2_CanStartStopService   37 wstr,sptr
#comfunc global IShellDispatch2_ShowBrowserBar        38 wstr,int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。