キャラデリ関数

キャラデリとは，メッセージとキャラクターデータを指定した相手に送 信する機能です．送信したキャラクターは，送信相手のデスクトップ上 で実行されます．

VisitTo

int VisitTo( 　　string to, 　　string dataname, 　　string message, 　　int callstyle, 　　void &func( string pid , string msg , string param ), 　　string param )[2.00以降]

機能	特定のユーザが実行中のChararinaへ，キャラクターを送信します．
引数	to 送信先ユーザのキャラリナID dataname キャラデリデータ名 message キャラデリ先へ送るメッセージ callstyle 呼び出しスタイルの指定 func キャラデリ先から戻ってきたときにコールバックする関数 param func関数の呼び出し時に渡される引数
戻り値	1 成功 -1 定義ファイルのオープンに失敗 -2 定義ファイルのフォーマット異常 -3 ファイルの送信に失敗 -4 ファイルの送信中にエラーが発生した -5 メッセージの送信に失敗した -6 メッセージの送信中にエラーが発生した その他 その他のエラー
説明	特定のユーザが実行中のChararinaへ，キャラクターを送信します． to引数にはキャラクターのキャラデリ先をキャラリナIDで指定します． dataname変数にはキャラデリデータ名を指定します．キャラデリデータ定義ファイル(*.vst) のファイル名部分(.vstを除く)がキャ ラデリデータ名になります． message変数にはキャラデリ先へ送るメッセージを指定します． このメッセージは，キャラデリさせたキャラクターの VisitorStartUpの引数にセットされます． キャラデリ先で実行されたキャラクターが終了すると，その情報 がキャラデリ元のChararinaへ通知されます．Chararinaがその通 知を受け取ると，func変数に指定したコールバック関 数が呼び出されます．キャラデリ先からのメッセージを，このコー ルバック関数で受け取ることも可能です． callstyle 0 キャラクターが動作していない場合(基底状態)に限り， func関数を呼び出します． 1 キャラクターの動作状態に拘わらず，割り込みの機構を使い func 関数を呼び出します．

例1	"test1"宛てにキャラデリします．この例ではhello.vstに定義されたデータがキャラデリに使用されます． VisitTo( "test1", "hello", "こんにちわ", 0, callback, "callback of hello" );