ホーム › System.Search › ISimpleCommandCreator

ISimpleCommandCreator

COM

📘 Microsoft Learn (日本語) · English

IID5e341ab7-02d0-11d1-900c-00a0c9063796継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

ファイルカタログを操作するためのメソッドを提供します。

メソッド 3

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

vtbl 3 HRESULT CreateICommand(IUnknown** ppIUnknown, IUnknown* pOuterUnk)

ICommand を作成します。

ppIUnknown	IUnknown**	out	コマンドの IUnknown を返します。
pOuterUnk	IUnknown*	in	省略可能な外部 unknown ポインターです。

戻り値

このメソッドが成功した場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 4 HRESULT VerifyCatalog(LPWSTR pwszMachine, LPWSTR pwszCatalogName)

カタログの場所を検証します。

pwszMachine	LPWSTR	in	カタログが存在するマシンです。
pwszCatalogName	LPWSTR	in	カタログ名です。

戻り値

カタログにアクセスできる場合は S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

vtbl 5 HRESULT GetDefaultCatalog(LPWSTR pwszCatalogName, DWORD cwcIn, DWORD* pcwcOut)

システムの既定のカタログを特定します。

pwszCatalogName	LPWSTR	in	カタログ名です。
cwcIn	DWORD	in	pwszCatalogName のサイズ (文字数) です。
pcwcOut	DWORD*	inout	カタログ名のサイズです。

戻り値

このメソッドが成功した場合は、IsapiDefaultCatalogDirectory レジストリ値の内容を返します。それ以外の場合は HRESULT エラーコードを返します。

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

HSP用 COM定義

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

出力引数:

#define global IID_ISimpleCommandCreator "{5E341AB7-02D0-11D1-900C-00A0C9063796}"
#usecom global ISimpleCommandCreator IID_ISimpleCommandCreator "{}"
#comfunc global ISimpleCommandCreator_CreateICommand     3 sptr,sptr
#comfunc global ISimpleCommandCreator_VerifyCatalog      4 wstr,wstr
#comfunc global ISimpleCommandCreator_GetDefaultCatalog  5 wstr,int,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_ISimpleCommandCreator "{5E341AB7-02D0-11D1-900C-00A0C9063796}"
#usecom global ISimpleCommandCreator IID_ISimpleCommandCreator "{}"
#comfunc global ISimpleCommandCreator_CreateICommand     3 sptr,sptr
#comfunc global ISimpleCommandCreator_VerifyCatalog      4 wstr,wstr
#comfunc global ISimpleCommandCreator_GetDefaultCatalog  5 wstr,int,sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。