Palm デバイス用 Mobile Link Listener C API

Palm デバイス用 Mobile Link Listener C API は、メッセージ処理用のメソッドとデバイス依存のメソッドが含まれる簡潔なプログラミング・インタフェースです。このインタフェースを使用すると、新しい Palm デバイス用の Listener や無線ネットワーク・アダプタ用の Listener を作成できます。

Listener API ファイル

API の実行に必要なファイルのリストと Palm デバイス用の実装例を次に示します。すべてのディレクトリは、install-dir を基準とした相対ディレクトリです。

ファイル名またはロケーション	説明
SDK\Listener\Palm\68k\cw\lib\PalmLsn.lib	ランタイム・ライブラリ。メッセージ処理ルーチン、Listener コントロール、Handler Editor が含まれます。
SDK\Listener\Palm\68k\cw\rsc	UI リソースが含まれます。
SDK\Listener\Palm\src\PalmLsn.h	ランタイム・ライブラリのヘッダと API。
SDK\Listener\Palm\src\Treo650.c	Treo 650 の実装

メッセージ処理用メソッド

Listener API では、a_palm_msg 構造体を使用して Listener メッセージを表現します。a_palm_msg インスタンスの割り当てと処理には、次のメソッドを使用します。

メソッド	説明
PalmLsnAllocate メソッド	新しい a_palm_msg インスタンスを返します。
PalmLsnDupMessage メソッド	a_palm_msg インスタンスのメッセージ・フィールドの値を初期化します。
PalmLsnDupSender メソッド	a_palm_msg インスタンスの送信元フィールドを初期化します。
PalmLsnDupTime メソッド	a_palm_msg インスタンスの時刻フィールドを初期化します。
PalmLsnFree メソッド	メッセージ用のメモリ領域を開放します。
PalmLsnProcess メソッド	設定データベース内のレコードに従ってメッセージを処理します。

デバイス依存メソッド

次のメソッドでは、本人確認の機能、登録機能、イベント処理機能を提供します。

メソッド	説明
PalmLsnCheckConfigDB メソッド	Listener 設定データベース内のエラーをレポートします。
PalmLsnGetConfigFileName メソッド	Listener 設定データベースの名前を含む文字列を返します。
PalmLsnNormalHandleEvent メソッド	アプリケーション・イベントを処理します。
PalmLsnNormalStart メソッド	Listener アプリケーション起動時のカスタムのアクションを登録します。
PalmLsnNormalStop メソッド	Listener アプリケーションがイベント・ループを終了するときのカスタム・アクションを実行します。
PalmLsnSpecialLaunch メソッド	デバイス依存の起動コードに応答します。
PalmLsnTargetCompanyID メソッド	デバイスの企業 ID または製造元 ID を返します。
PalmLsnTargetDeviceID メソッド	ターゲット・デバイス ID を返します。