ホーム › Networking.RemoteDifferentialCompression › ISimilarity

ISimilarity

COM

IID96236a83-9dbc-11da-9e3f-0011114ae311継承元IUnknown自前メソッド開始 vtbl3

メソッド 7

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

vtbl 3 HRESULT CreateTable(LPWSTR path, BOOL truncate, BYTE* securityDescriptor, DWORD recordSize, RdcCreatedTables* isNew)

path	LPWSTR	in	テーブルを作成するファイルパスを指定する LPWSTR である。
truncate	BOOL	in	既存ファイルを切り詰めて初期化するかを示す BOOL である。
securityDescriptor	BYTE*	in	作成時に適用するセキュリティ記述子の BYTE バッファ。既定でよい場合は NULL。
recordSize	DWORD	in	1レコードのバイトサイズを指定する DWORD である。
isNew	RdcCreatedTables*	out	テーブルが新規作成されたかを示す RdcCreatedTables を受け取るポインタである。

vtbl 4 HRESULT CreateTableIndirect(ISimilarityTraitsMapping* mapping, IRdcFileWriter* fileIdFile, BOOL truncate, DWORD recordSize, RdcCreatedTables* isNew)

mapping	ISimilarityTraitsMapping*	in	特性テーブルの背後で使用する ISimilarityTraitsMapping である。
fileIdFile	IRdcFileWriter*	in	ファイルID を書き込む先の IRdcFileWriter である。
truncate	BOOL	in	既存内容を切り詰めて初期化するかを示す BOOL である。
recordSize	DWORD	in	1レコードのバイトサイズを指定する DWORD である。
isNew	RdcCreatedTables*	out	テーブルが新規作成されたかを示す RdcCreatedTables を受け取るポインタである。

vtbl 5 HRESULT CloseTable(BOOL isValid)

isValid

BOOL

テーブル内容を有効として確定するか(TRUE)破棄するか(FALSE)を示す BOOL である。

vtbl 6 HRESULT Append(SimilarityFileId* similarityFileId, SimilarityData* similarityData)

similarityFileId	SimilarityFileId*	in	追加するファイルID を指す SimilarityFileId ポインタである。
similarityData	SimilarityData*	in	ファイルID に関連付ける類似度データを指す SimilarityData ポインタである。

vtbl 7 HRESULT FindSimilarFileId(SimilarityData* similarityData, WORD numberOfMatchesRequired, DWORD resultsSize, IFindSimilarResults** findSimilarResults)

similarityData	SimilarityData*	in	検索キーとなる類似度データを指す SimilarityData ポインタである。
numberOfMatchesRequired	WORD	in	一致とみなすのに必要な最小特性一致数を指定する WORD である。
resultsSize	DWORD	in	返却する結果の最大数を指定する DWORD である。
findSimilarResults	IFindSimilarResults**	out	検索結果を保持する IFindSimilarResults を受け取る出力ポインタである。

vtbl 8 HRESULT CopyAndSwap(ISimilarity* newSimilarityTables, ISimilarityReportProgress* reportProgress)

newSimilarityTables	ISimilarity*	in	コピー先となる新しい類似度テーブル ISimilarity である。
reportProgress	ISimilarityReportProgress*	in	進捗を通知する ISimilarityReportProgress コールバック。不要なら NULL。

vtbl 9 HRESULT GetRecordCount(DWORD* recordCount)

recordCount

DWORD*

out

テーブル内のレコード総数を受け取る DWORD ポインタである。

HSP用 COM定義

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

出力引数:

#define global IID_ISimilarity "{96236A83-9DBC-11DA-9E3F-0011114AE311}"
#usecom global ISimilarity IID_ISimilarity "{}"
#comfunc global ISimilarity_CreateTable          3 wstr,int,var,int,var
#comfunc global ISimilarity_CreateTableIndirect  4 sptr,sptr,int,int,var
#comfunc global ISimilarity_CloseTable           5 int
#comfunc global ISimilarity_Append               6 var,var
#comfunc global ISimilarity_FindSimilarFileId    7 var,int,int,sptr
#comfunc global ISimilarity_CopyAndSwap          8 sptr,sptr
#comfunc global ISimilarity_GetRecordCount       9 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_ISimilarity "{96236A83-9DBC-11DA-9E3F-0011114AE311}"
#usecom global ISimilarity IID_ISimilarity "{}"
#comfunc global ISimilarity_CreateTable          3 wstr,int,sptr,int,sptr
#comfunc global ISimilarity_CreateTableIndirect  4 sptr,sptr,int,int,sptr
#comfunc global ISimilarity_CloseTable           5 int
#comfunc global ISimilarity_Append               6 sptr,sptr
#comfunc global ISimilarity_FindSimilarFileId    7 sptr,int,int,sptr
#comfunc global ISimilarity_CopyAndSwap          8 sptr,sptr
#comfunc global ISimilarity_GetRecordCount       9 sptr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。