serializeメソッド

中断再開プラグインで，中断情報を直列化するためのメソッドです。パラメタに指定された中断情報（suspendInfo）をXML形式に直列化し，結果を出力ストリームoutに書き込みます。このメソッドでは，出力ストリームoutのクローズ処理はしません。呼び出し側でクローズ処理を実施してください。

中断情報の直列化，およびストリームへの出力に失敗した場合は，UCNPPluginException例外をスローします。このメソッドがスローするUCNPPluginException例外の詳細メッセージには，ナビゲーションプラットフォームのメッセージIDが付きます。スローされた例外をハンドリングして，ダイアログに表示するメッセージを設定したUCNPPluginException例外をスローしてください。

＜この項の構成＞: (1)　形式; (2)　引数; (3)　戻り値; (4)　例外

(1)　形式

(2)　引数

(a)　suspendInfo

中断情報が格納されます。

(b)　out

直列化した中断情報を書き込む出力ストリームが格納されます。

(3)　戻り値

(4)　例外

UCNPPluginException - 中断情報の直列化，および出力に失敗した場合

このメソッドでエラーが発生した場合，直列化処理は中断され，UCNPPluginException例外がスローされます。エラーの一覧を次に示します。

表5-14　serializeメソッドで発生するエラー一覧

エラー	メッセージID
suspendInfoパラメタにnullを指定した場合	KDCZ10083-E
outパラメタにnullを指定した場合	KDCZ10083-E
suspendInfoパラメタに不正なオブジェクト（ナビゲーションプラットフォームで生成していないオブジェクト）を指定した場合	KDCZ10084-E
アクセス権，ディスク容量などの問題でパラメタに指定された出力ストリームに書き込みができなかった場合	KDCZ10085-E

5.8.1 serializeメソッド

(1) 形式

(2) 引数

(a) suspendInfo

(b) out

(3) 戻り値