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

IMLangStringAStr

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

メソッド 8

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

vtbl 7 HRESULT SetAStr(INT lDestPos, INT lDestLen, DWORD uCodePage, LPSTR pszSrc, INT cchSrc, INT* pcchActual, INT* plActualLen)
lDestPosINTin設定先の開始位置。
lDestLenINTin置き換える領域の長さ。-1で末尾まで。
uCodePageDWORDinソースANSI文字列の解釈に用いるコードページ番号。
pszSrcLPSTRin設定するソースのANSI文字列。
cchSrcINTinソース文字列のバイト数。-1でヌル終端まで。
pcchActualINT*outoptional実際にソースから読み取ったバイト数を受け取る出力ポインタ。
plActualLenINT*outoptional設定後の対象領域の実際の長さを受け取る出力ポインタ。
vtbl 8 HRESULT SetStrBufA(INT lDestPos, INT lDestLen, DWORD uCodePage, IMLangStringBufA* pSrcBuf, INT* pcchActual, INT* plActualLen)
lDestPosINTin設定先の開始位置。
lDestLenINTin置き換える領域の長さ。-1で末尾まで。
uCodePageDWORDinソースバッファのANSI文字列を解釈するコードページ番号。
pSrcBufIMLangStringBufA*inoptional設定内容を供給するANSI文字列バッファ(IMLangStringBufA)へのポインタ。
pcchActualINT*outoptional実際にバッファから読み取ったバイト数を受け取る出力ポインタ。
plActualLenINT*outoptional設定後の対象領域の実際の長さを受け取る出力ポインタ。
vtbl 9 HRESULT GetAStr(INT lSrcPos, INT lSrcLen, DWORD uCodePageIn, DWORD* puCodePageOut, LPSTR pszDest, INT cchDest, INT* pcchActual, INT* plActualLen)
lSrcPosINTin取得元の開始位置。
lSrcLenINTin取得する長さ。
uCodePageInDWORDin出力に希望するANSIコードページ番号。
puCodePageOutDWORD*optional実際に使用されたコードページ番号を受け取る出力ポインタ。
pszDestLPSTRoutoptionalANSI文字列を書き込む呼び出し側のバッファ。
cchDestINTin出力バッファの容量(バイト数)。
pcchActualINT*outoptional実際に出力バッファへ書き込んだバイト数を受け取る出力ポインタ。
plActualLenINT*outoptional取得元から読み取った実際の長さを受け取る出力ポインタ。
vtbl 10 HRESULT GetStrBufA(INT lSrcPos, INT lSrcMaxLen, DWORD* puDestCodePage, IMLangStringBufA** ppDestBuf, INT* plDestLen)
lSrcPosINTin取得元の開始位置。
lSrcMaxLenINTin取得する最大長。
puDestCodePageDWORD*outoptional出力バッファに用いられたコードページ番号を受け取る出力ポインタ。
ppDestBufIMLangStringBufA**out内容を参照するためのANSI文字列バッファ(IMLangStringBufA)を受け取る出力ポインタ。
plDestLenINT*outoptional取得できた実際の長さを受け取る出力ポインタ。
vtbl 11 HRESULT LockAStr(INT lSrcPos, INT lSrcLen, INT lFlags, DWORD uCodePageIn, INT cchRequest, DWORD* puCodePageOut, LPSTR* ppszDest, INT* pcchDest, INT* plDestLen)
lSrcPosINTinロックを開始する位置。
lSrcLenINTinロックする領域の長さ。
lFlagsINTinロック動作を制御するフラグ値。
uCodePageInDWORDin出力に希望するANSIコードページ番号。
cchRequestINTin確保を要求する追加のバイト数。
puCodePageOutDWORD*outoptional実際に使用されたコードページ番号を受け取る出力ポインタ。
ppszDestLPSTR*outoptionalロックされ直接書き込み可能なANSIバッファの先頭を受け取る出力ポインタ。
pcchDestINT*outoptionalロックされたバッファの容量(バイト数)を受け取る出力ポインタ。
plDestLenINT*outoptionalロック対象領域の実際の長さを受け取る出力ポインタ。
vtbl 12 HRESULT UnlockAStr(LPSTR pszSrc, INT cchSrc, INT* pcchActual, INT* plActualLen)
pszSrcLPSTRinLockAStrで取得したロック解除対象のバッファポインタ。
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_IMLangStringAStr "{C04D65D2-B70D-11D0-B188-00AA0038C969}"
#usecom global IMLangStringAStr IID_IMLangStringAStr "{}"
#comfunc global IMLangStringAStr_SetAStr     7 int,int,int,str,int,var,var
#comfunc global IMLangStringAStr_SetStrBufA  8 int,int,int,sptr,var,var
#comfunc global IMLangStringAStr_GetAStr     9 int,int,int,var,var,int,var,var
#comfunc global IMLangStringAStr_GetStrBufA  10 int,int,var,sptr,var
#comfunc global IMLangStringAStr_LockAStr    11 int,int,int,int,int,var,var,var,var
#comfunc global IMLangStringAStr_UnlockAStr  12 str,int,var,var
#comfunc global IMLangStringAStr_SetLocale   13 int,int,int
#comfunc global IMLangStringAStr_GetLocale   14 int,int,var,var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。