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

IMLangStringWStr

COM
IIDc04d65d0-b70d-11d0-b188-00aa0038c969継承元IMLangString自前メソッド開始 vtbl7

メソッド 8

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

vtbl 7 HRESULT SetWStr(INT lDestPos, INT lDestLen, LPWSTR pszSrc, INT cchSrc, INT* pcchActual, INT* plActualLen)
lDestPosINTin設定先の開始位置。
lDestLenINTin置き換える領域の長さ。-1で末尾まで。
pszSrcLPWSTRin設定するソースのWide文字列。
cchSrcINTinソース文字列の文字数。-1でヌル終端まで。
pcchActualINT*outoptional実際にソースから読み取った文字数を受け取る出力ポインタ。
plActualLenINT*outoptional設定後の対象領域の実際の長さを受け取る出力ポインタ。
vtbl 8 HRESULT SetStrBufW(INT lDestPos, INT lDestLen, IMLangStringBufW* pSrcBuf, INT* pcchActual, INT* plActualLen)
lDestPosINTin設定先の開始位置。
lDestLenINTin置き換える領域の長さ。-1で末尾まで。
pSrcBufIMLangStringBufW*inoptional設定内容を供給するWide文字列バッファ(IMLangStringBufW)へのポインタ。
pcchActualINT*outoptional実際にバッファから読み取った文字数を受け取る出力ポインタ。
plActualLenINT*outoptional設定後の対象領域の実際の長さを受け取る出力ポインタ。
vtbl 9 HRESULT GetWStr(INT lSrcPos, INT lSrcLen, LPWSTR pszDest, INT cchDest, INT* pcchActual, INT* plActualLen)
lSrcPosINTin取得元の開始位置。
lSrcLenINTin取得する長さ。
pszDestLPWSTRoutoptionalWide文字列を書き込む呼び出し側のバッファ。
cchDestINTin出力バッファの容量(文字数)。
pcchActualINT*outoptional実際に出力バッファへ書き込んだ文字数を受け取る出力ポインタ。
plActualLenINT*outoptional取得元から読み取った実際の長さを受け取る出力ポインタ。
vtbl 10 HRESULT GetStrBufW(INT lSrcPos, INT lSrcMaxLen, IMLangStringBufW** ppDestBuf, INT* plDestLen)
lSrcPosINTin取得元の開始位置。
lSrcMaxLenINTin取得する最大長。
ppDestBufIMLangStringBufW**out内容を参照するためのWide文字列バッファ(IMLangStringBufW)を受け取る出力ポインタ。
plDestLenINT*outoptional取得できた実際の長さを受け取る出力ポインタ。
vtbl 11 HRESULT LockWStr(INT lSrcPos, INT lSrcLen, INT lFlags, INT cchRequest, LPWSTR* ppszDest, INT* pcchDest, INT* plDestLen)
lSrcPosINTinロックを開始する位置。
lSrcLenINTinロックする領域の長さ。
lFlagsINTinロック動作を制御するフラグ値。
cchRequestINTin確保を要求する追加の文字数。
ppszDestLPWSTR*outoptionalロックされ直接書き込み可能なWideバッファの先頭を受け取る出力ポインタ。
pcchDestINT*outoptionalロックされたバッファの容量(文字数)を受け取る出力ポインタ。
plDestLenINT*outoptionalロック対象領域の実際の長さを受け取る出力ポインタ。
vtbl 12 HRESULT UnlockWStr(LPWSTR pszSrc, INT cchSrc, INT* pcchActual, INT* plActualLen)
pszSrcLPWSTRinLockWStrで取得したロック解除対象のバッファポインタ。
cchSrcINTin実際に書き込んだ文字数。
pcchActualINT*outoptional確定処理で実際に取り込まれた文字数を受け取る出力ポインタ。
plActualLenINT*outoptionalロック解除後の領域の実際の長さを受け取る出力ポインタ。
vtbl 13 HRESULT SetLocale(INT lDestPos, INT lDestLen, DWORD locale)
lDestPosINTinロケールを設定する開始位置。
lDestLenINTinロケールを適用する範囲の長さ。-1で末尾まで。
localeDWORDin設定するロケール識別子(LCID)。
vtbl 14 HRESULT GetLocale(INT lSrcPos, INT lSrcMaxLen, DWORD* plocale, INT* plLocalePos, INT* plLocaleLen)
lSrcPosINTinロケールを取得する開始位置。
lSrcMaxLenINTin調査する最大範囲の長さ。
plocaleDWORD*outoptional取得したロケール識別子(LCID)を受け取る出力ポインタ。
plLocalePosINT*outoptional同一ロケールが続く範囲の開始位置を受け取る出力ポインタ。
plLocaleLenINT*outoptional同一ロケールが続く範囲の長さを受け取る出力ポインタ。

HSP用 COM定義

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

出力引数:
#define global IID_IMLangStringWStr "{C04D65D0-B70D-11D0-B188-00AA0038C969}"
#usecom global IMLangStringWStr IID_IMLangStringWStr "{}"
#comfunc global IMLangStringWStr_SetWStr     7 int,int,wstr,int,var,var
#comfunc global IMLangStringWStr_SetStrBufW  8 int,int,sptr,var,var
#comfunc global IMLangStringWStr_GetWStr     9 int,int,var,int,var,var
#comfunc global IMLangStringWStr_GetStrBufW  10 int,int,sptr,var
#comfunc global IMLangStringWStr_LockWStr    11 int,int,int,int,var,var,var
#comfunc global IMLangStringWStr_UnlockWStr  12 wstr,int,var,var
#comfunc global IMLangStringWStr_SetLocale   13 int,int,int
#comfunc global IMLangStringWStr_GetLocale   14 int,int,var,var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。