LMS_GetAttributeText

この関数は、指定されたファイルの中にある属性のテキスト情報を取得することができます。 属性情報はすべて固定長で出力されるため、可変長文字列を含めることができません。 属性情報として出される文字列は、オフセット値が書き込まれています。 この関数は、そのオフセット値から文字列へのポインタを取得することができます。

この関数を利用するにはメッセージバイナリファイルが 属性情報ブロック(ATR1)を含めるように設定しなければなりません。 もし含まれていない場合はアサートに失敗します。

構文

const void* LMS_GetAttributeText( LMSMsgFile *pFile, libms_s32_t offset );

引数

引数名	型	意味
pFile	LMSMsgFile*	インデックス番号を検索する対象のメッセージファイルオブジェクトを指定してください(LMS_InitMessage関数で返ってきた値)。
offset	libms_s32_t	テキストのオフセット値を指定します。 この値は、LMS_GetAttributeを利用して得られるポインタと、属性の構造情報から取得できます。

戻り値

テキストへのポインタが返ります。 テキストはメッセージバイナリファイル(*.msbt)を出力するときに設定された文字コード形式でエンコードされてします。 終端にはNULL文字が来ます。