Win32 API 日本語リファレンス
ホームGlobalization › IMLangStringBufA

IMLangStringBufA

COM
IIDd24acd23-ba72-11d0-b188-00aa0038c969継承元IUnknown自前メソッド開始 vtbl3

メソッド 5

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

vtbl 3 HRESULT GetStatus(INT* plFlags, INT* pcchBuf)
plFlagsINT*outoptionalバッファの状態を示すフラグ値を受け取る出力ポインタ。
pcchBufINT*outoptionalバッファに格納可能な文字数(容量)を受け取る出力ポインタ。
vtbl 4 HRESULT LockBuf(INT cchOffset, INT cchMaxLock, CHAR** ppszBuf, INT* pcchBuf)
cchOffsetINTinロックを開始するバッファ先頭からの文字オフセット。
cchMaxLockINTinロックして書き込みたい最大文字数。
ppszBufCHAR**outロックされたANSI(CHAR)バッファ領域の先頭ポインタを受け取る出力ポインタ。
pcchBufINT*outoptional実際にロックできた文字数を受け取る出力ポインタ。
vtbl 5 HRESULT UnlockBuf(LPSTR pszBuf, INT cchOffset, INT cchWrite)
pszBufLPSTRinLockBufで取得したバッファポインタ(ロック解除対象)。
cchOffsetINTinロック時に指定したのと同じ文字オフセット。
cchWriteINTin実際に書き込んだ文字数。
vtbl 6 HRESULT Insert(INT cchOffset, INT cchMaxInsert, INT* pcchActual)
cchOffsetINTin文字列を挿入するバッファ先頭からの文字オフセット。
cchMaxInsertINTin挿入のために確保したい最大文字数。
pcchActualINT*outoptional実際に挿入領域として確保できた文字数を受け取る出力ポインタ。
vtbl 7 HRESULT Delete(INT cchOffset, INT cchDelete)
cchOffsetINTin削除を開始するバッファ先頭からの文字オフセット。
cchDeleteINTin削除する文字数。

HSP用 COM定義

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

出力引数:
#define global IID_IMLangStringBufA "{D24ACD23-BA72-11D0-B188-00AA0038C969}"
#usecom global IMLangStringBufA IID_IMLangStringBufA "{}"
#comfunc global IMLangStringBufA_GetStatus  3 var,var
#comfunc global IMLangStringBufA_LockBuf    4 int,int,var,var
#comfunc global IMLangStringBufA_UnlockBuf  5 str,int,int
#comfunc global IMLangStringBufA_Insert     6 int,int,var
#comfunc global IMLangStringBufA_Delete     7 int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。