a_palm_msg インスタンスのメッセージ・フィールドの値を初期化します。

構文

Err PalmLsnDupMessage(
    struct a_palm_msg * const msg,
    Char const * message
)

パラメータ

戻り値

Palm OS のエラー・コード。errNone は正常終了を表します。

備考

PalmLsnDupMessage メソッドは、テキスト・メッセージを複製し、件名、内容、送信元の各フィールドを抽出して、これらの値を a_palm_msg インスタンスに割り当てます。

送信元フィールドは、メッセージ内に現れない場合は抽出されません。PalmLsnDupSender を使用すると、PalmLsnDupMessage で抽出された送信元フィールドが上書きされます。

参照

• PalmLsnDupSender メソッド
• PalmLsnDupTime メソッド
• メッセージ処理用メソッド

例

次に示す例は、Treo 650 smartphone の実装での使用例です。テキスト・メッセージを取り出し、PalmLsnDupMessage を呼び出して a_palm_msg インスタンス内の適切なフィールドを初期化しています。

// Retrieve the entire message body
ret = PhnLibGetText( libRef, id, &msgBodyH );
if (ret != errNone) {
    // handle error
    goto done;  
}
msgBody = (Char *)MemHandleLock( msgBodyH );
ret = PalmLsnDupMessage( ulMsg, msgBody );

// msgBodyH must be disposed of by the caller
MemHandleUnlock(msgBodyH);
MemHandleFree(msgBodyH);
if (ret != errNone) {
    // handle error
    goto done;
}