Win32 API 日本語リファレンス
ホーム › Media.Speech › ISpeechObjectToken

ISpeechObjectToken

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

メソッド 13

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

vtbl 7 HRESULT get_Id(LPWSTR* ObjectId)
ObjectIdLPWSTR*outトークンを一意に識別するレジストリパス文字列を受け取るポインタ。
vtbl 8 HRESULT get_DataKey(ISpeechDataKey** DataKey)
DataKeyISpeechDataKey**outトークンに関連付くデータキー(ISpeechDataKey)を受け取るポインタ。
vtbl 9 HRESULT get_Category(ISpeechObjectTokenCategory** Category)
CategoryISpeechObjectTokenCategory**outトークンが属するカテゴリ(ISpeechObjectTokenCategory)を受け取るポインタ。
vtbl 10 HRESULT GetDescription(INT Locale, LPWSTR* Description)
LocaleINTin説明を取得するロケール識別子(LCID)。
DescriptionLPWSTR*out指定ロケールでのトークン説明文字列を受け取るポインタ。
vtbl 11 HRESULT SetId(LPWSTR Id, LPWSTR CategoryID, VARIANT_BOOL CreateIfNotExist)
IdLPWSTRin設定するトークン識別子(レジストリパス)。
CategoryIDLPWSTRinトークンが属するカテゴリの識別子。
CreateIfNotExistVARIANT_BOOLin存在しない場合に新規作成するか。VARIANT_TRUEで作成する。
vtbl 12 HRESULT GetAttribute(LPWSTR AttributeName, LPWSTR* AttributeValue)
AttributeNameLPWSTRin取得する属性の名前。
AttributeValueLPWSTR*out属性値を受け取る文字列ポインタ。
vtbl 13 HRESULT CreateInstance(IUnknown* pUnkOuter, SpeechTokenContext ClsContext, IUnknown** Object)
pUnkOuterIUnknown*inoptionalアグリゲーション用の外側IUnknown。通常NULL。
ClsContextSpeechTokenContextin生成するCOMオブジェクトの実行コンテキスト(SpeechTokenContext)。
ObjectIUnknown**out生成されたオブジェクトのIUnknownを受け取るポインタ。
vtbl 14 HRESULT Remove(LPWSTR ObjectStorageCLSID)
ObjectStorageCLSIDLPWSTRin削除対象のストレージCLSID文字列。トークン全体を削除する場合の指定。
vtbl 15 HRESULT GetStorageFileName(LPWSTR ObjectStorageCLSID, LPWSTR KeyName, LPWSTR FileName, SpeechTokenShellFolder Folder, LPWSTR* FilePath)
ObjectStorageCLSIDLPWSTRinファイルを関連付けるストレージのCLSID文字列。
KeyNameLPWSTRinファイル名を格納するデータキー名。
FileNameLPWSTRin対象ファイル名。
FolderSpeechTokenShellFolderinファイルを配置する特殊フォルダ(SpeechTokenShellFolder)。
FilePathLPWSTR*out解決された完全ファイルパスを受け取るポインタ。
vtbl 16 HRESULT RemoveStorageFileName(LPWSTR ObjectStorageCLSID, LPWSTR KeyName, VARIANT_BOOL DeleteFile)
ObjectStorageCLSIDLPWSTRin対象のストレージCLSID文字列。
KeyNameLPWSTRin削除するファイル名を保持するデータキー名。
DeleteFileVARIANT_BOOLin実ファイルも削除するか。VARIANT_TRUEで物理削除する。
vtbl 17 HRESULT IsUISupported(LPWSTR TypeOfUI, VARIANT* ExtraData, IUnknown* Object, VARIANT_BOOL* Supported)
TypeOfUILPWSTRin問い合わせるUI種別を示す文字列。
ExtraDataVARIANT*inUIへ渡す追加データのVARIANTポインタ。不要ならNULL相当。
ObjectIUnknown*inoptionalUIに関連するオブジェクトへのIUnknown。NULL可。
SupportedVARIANT_BOOL*out指定UIがサポートされるかを受け取るVARIANT_BOOLポインタ。
vtbl 18 HRESULT DisplayUI(INT hWnd, LPWSTR Title, LPWSTR TypeOfUI, VARIANT* ExtraData, IUnknown* Object)
hWndINTinUIダイアログの親ウィンドウハンドル(整数)。
TitleLPWSTRinUIダイアログのタイトル文字列。
TypeOfUILPWSTRin表示するUI種別を示す文字列。
ExtraDataVARIANT*inUIへ渡す追加データのVARIANTポインタ。
ObjectIUnknown*inoptionalUIに関連するオブジェクトへのIUnknown。NULL可。
vtbl 19 HRESULT MatchesAttributes(LPWSTR Attributes, VARIANT_BOOL* Matches)
AttributesLPWSTRin照合する属性条件式の文字列(セミコロン区切り)。
MatchesVARIANT_BOOL*out条件に合致したかを受け取るVARIANT_BOOLポインタ。

HSP用 COM定義

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

出力引数: 
#define global IID_ISpeechObjectToken "{C74A3ADC-B727-4500-A84A-B526721C8B8C}"
#usecom global ISpeechObjectToken IID_ISpeechObjectToken "{}"
#comfunc global ISpeechObjectToken_get_Id                 7 var
#comfunc global ISpeechObjectToken_get_DataKey            8 sptr
#comfunc global ISpeechObjectToken_get_Category           9 sptr
#comfunc global ISpeechObjectToken_GetDescription         10 int,var
#comfunc global ISpeechObjectToken_SetId                  11 wstr,wstr,int
#comfunc global ISpeechObjectToken_GetAttribute           12 wstr,var
#comfunc global ISpeechObjectToken_CreateInstance         13 sptr,int,sptr
#comfunc global ISpeechObjectToken_Remove                 14 wstr
#comfunc global ISpeechObjectToken_GetStorageFileName     15 wstr,wstr,wstr,int,var
#comfunc global ISpeechObjectToken_RemoveStorageFileName  16 wstr,wstr,int
#comfunc global ISpeechObjectToken_IsUISupported          17 wstr,var,sptr,var
#comfunc global ISpeechObjectToken_DisplayUI              18 int,wstr,wstr,var,sptr
#comfunc global ISpeechObjectToken_MatchesAttributes      19 wstr,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。