- 追加された行はこのように表示されます。
- 削除された行は
このように表示されます。
{{div_begin}}
[[← 9 章に戻る|C/C++ Sync Suite Companion601/9]] [[↑トップへ|C/C++ Sync Suite Companion601]]
{{div_end}}
{{div_begin style="margin-bottom:-10px"}}
!!!A クイック スタート: コンジットをビルドするための Visual C++ .NET の使用
{{div_end}}
{{div_begin "style='position:absolute;right:0px;font-size:70%;margin-right:15px;margin-top:15px;width:250px;'"}}
*{{goto Step 1: Use the Conduit Wizard to Create Sample Code,ステップ 1: サンプル コードを作成するためにコンジット ウィザードを使用する}}
**{{goto Start the Conduit Wizard,コンジット ウィザードを開始する}}
**{{goto Use the Conduit Wizard,コンジット ウィザードを使用する}}
*{{goto Step 2: Prepare Palm OS Cobalt Simulator,ステップ 2: Palm OS Cobalt シミュレータを準備する}}
**{{goto Configure Simulator for a Network HotSync Operation,ネットワーク HotSync 操作のためにシミュレータをコンフィグレーションする}}
**{{goto Disable Time-Outs,タイム-アウトを無効にする}}
**{{goto Install Memo Port on Simulator,メモ移植版をシミュレータにインストールする}}
**{{goto Create Sample Data with Memo Port,メモ帳移植版でサンプル データを作成する}}
*{{goto Step 3: Configure the Project Settings and Build the DLL,ステップ 3: プロジェクト設定のコンフィグレーションし、DLL をビルドする}}
*{{goto Step 4: Single-step/Debug Your Conduit,ステップ 4: あなたのコンジットをステップごとに実行する/デバッグする}}
**{{goto Start Debugging,デバッグの開始}}
**{{goto Check the Custom Dialog Box,カスタム ダイアログ ボックスのチェック}}
**{{goto Perform a HotSync Operation,HotSync の実行}}
**{{goto Save Conduit Inspector Logs,コンジット検証ログの保存}}
*{{goto Examine the MyConduitData.xml File,MyConduit.xml ファイルを検証する}}
{{div_end}}
{{div_begin "style='position:relative;padding:0px;padding-right:5px;padding-left:10px;margin-right:250px;margin-top:20px;width:auto;border-right-style:dotted;border-right-width:2px;border-right-color:silver;'"}}
'''訳者: CDK 6.0.1 は、VC++ .NET 2002 と VC++ .NET 2003 用のコンジット作成ウィザードを提供しているのですが、これらを VC++ .NET 2005 (Express Edition) で利用する方法がわかりません。利用する方法をご存知の方、利用できないということをご存知の方は是非教えてください。'''{{goto comments,コメント欄|C/C++ Sync Suite Companion601}} '''に投稿してください。'''
'''訳者: CDK 6.0.1 は、VC++ .NET 2002 と VC++ .NET 2003 用のコンジット作成ウィザードを提供しているのですが、これらを VC++ .NET 2005 (Express Edition) で利用する方法がわかりません。利用する方法をご存知の方、利用できないということをご存知の方は是非教えてください。'''
このクイック スタート ガイドは、あなたが Visual C++ .NET のコンジット ウィザードで生成されるサンプル コンジットを作成し、デバッグを開始するプロセスをステップを追って説明します。あなたが作成するコンジットは、ハンドヘルド上のメモ帳移植版 [{{goto 1,1}}] データベースとデスクトップ上の XML ファイルとの同期をとります。メモ帳移植版 [{{goto 1,1}}] アプリケーションは、スキーマ データベースではなく拡張データベースを使用する Palm OS Cobalt メモ帳のバージョンです。これらのデータベースのタイプの違いについての詳細は、''Introduction to Conduit Development'' の {{goto Schema vs. Non-schema Databases,スキーマ データベース 対 非-スキーマ データベース|Introduction to Conduit Development601/8}} を参照してください。
このクイック スタート ガイドの中でウィザードが生成するコードは、{{goto extended database,拡張データベース|Introduction to Conduit Development601/Glossary}} に対して機能する拡張 Generic Conduit Framework をベースにします。あなたがこのガイドを終了したとき、あなたは生成されたコードを、このフレームワークをあなた自身のコンジットの中でどのように使用するかの例として検証することができます。
このガイドは以下の主要なステップに分けられます:
*{{goto Step 1: Use the Conduit Wizard to Create Sample Code,ステップ 1: サンプル コードを作成するためにコンジット ウィザードを使用する}}
*{{goto Step 2: Prepare Palm OS Cobalt Simulator,ステップ 2: Palm OS Cobalt シミュレータを準備する}}
*{{goto Step 3: Configure the Project Settings and Build the DLL,ステップ 3: プロジェクト設定のコンフィグレーションし、DLL をビルドする}}
*{{goto Step 4: Single-step/Debug Your Conduit,ステップ 4: あなたのコンジットをステップごとに実行する/デバッグする}}
*{{goto Examine the MyConduitData.xml File,MyConduit.xml ファイルを検証する}}
このガイドは以下のように仮定します:
*あなたは Visual C++ .NET をインストールして使用している（以後は VC と記述します）。
*あなたは CDK の C/C++ Sync Suite をデフォルトの場所にインストールしている（{{span style='color:blue;font-family:monospace;',<CDK>}}）。
*あなたは Palm OS Cobalt シミュレータをインストールしている。シミュレータを取得するには、''Conduit Development Utilities Guide'' の [[第 8 章 「Palm OS シミュレータとの同期」|Conduit Development Utilities Guide601/8]] を参照してください。
::NOTE
:::CDK インストールのプロセスの一部としてコンジット ウィザードを VC につなげるため、CDK をインストールする前に VC をインストールしてください。さもないと、コンジット ウィザードは使用不能になります。VC が '''New > Projects > Visual C++ Projects''' ダイアログ ボックスの中に '''Palm OS Conduit''' を表示しない場合、あなたはコンジット ウィザードを手動でインストールする必要があります。''Conduit Development Utilities Guide'' の {{goto Installing the Conduit Wizard,「コンジット ウィザードのインストール」|Conduit Development Utilities Guide601/2}} を参照してください。
!!{{anchor Step 1: Use the Conduit Wizard to Create Sample Code}}ステップ 1: サンプル コードを作成するためにコンジット ウィザードを使用する {{goto top,^TOP^}}
このステップでは、あなたはコンジット ウィザードを使って、ハンドヘルド上のメモ帳移植版 [{{goto 1,1}}] アプリケーションによって使用されるデータベースをデスクトップ上の XML ファイルと同期させるコンジット コードを作成します。
!{{anchor Start the Conduit Wizard}}コンジット ウィザードを開始する {{goto top,^TOP^}}
*1. VC を開始して、'''File > New > Project''' をクリックします。
*2. '''Project Types''' 下の '''Visual C++ Projects''' フォルダをクリックして {{goto Figure A.1,図 A.1}} で示されているようなインストールされたすべての C++ プロジェクト ウィザードを表示します。
{{anchor Figure A.1}}
'''図 A.1 コンジット ウィザードの選択'''
{{img qs_cnwiz_000.jpg,style='width:531px;height:364px;'}}
*3. '''Templates''' 下の '''Palm OS Conduit''' をクリックします。
*4. '''Name''' ボックスにあなたのプロジェクトの名前として {{span style='color:blue;font-family:monospace;',MyConduit}} と入力して、それの置き場所を入力します。
::重要
:::あなたのプロジェクト名は慎重に決めてください。なぜなら、コンジット ウィザードはそれをファイル名とオブジェクト名として使用するからです。あなたのプロジェクト名が C 言語の識別子のルールに従わない場合、あなたのプロジェクトはコンパイルされないかもしれません。
*5. '''OK''' をクリックします。
!{{anchor Use the Conduit Wizard}}コンジット ウィザードを使用する {{goto top,^TOP^}}
コンジット ウィザードはあなたにあなたのコンジットを設計するための選択肢を表示します（{{goto Figure A.2,図 A.2}}）。各選択肢は以下のステップで説明します。
{{anchor Figure A.2}}
'''図 A.2 コンジット ウィザードの選択肢'''
{{img qs_cnwiz_001.jpg,style='width:615px;height:430px;'}}
*6. '''Conduit Type''' 下の '''Generic Conduit for extended databases''' をクリックします。ウィザードは {{goto extended database,拡張データベース|Introduction to Conduit Development601/Glossary}} のための C++ Generic Conduit Framework をベースにしたプロジェクト ファイルとソース コードを生成します。
*7. '''Desktop file format''' 下の '''XML''' をクリックします。あなたのコンジットはいずれかの拡張データベースを表すように構成されている XML ファイルと同期をとります。いずれかのテキスト エディタまたは XML エディタを使用すると、容易にこのファイルへの変更を実行、閲覧することができます。
*8. '''Registration''' 下の '''Folder registered''' をクリックします。あなたのコンジットは、単純にあなたのコンジット DLL をインストール時に {{span style='color:blue;font-family:monospace;',Conduits}} フォルダに置くことによって、HotSync マネージャに登録されます。フォルダ-登録コンジットのために、あなたは以下のことも指定しなければなりません:
{{div_begin style="margin-left:2em;"}}
*'''作成者 ID:''' HotSync マネージャがコンジットを識別するためのキーです。あなたは値を指定しなければなりません。このクイック スタート ガイドでは、コンジット ウィザードのデフォルト値である {{span style='color:blue;font-family:monospace;',"'memO'"}} を使用します（最後の文字は大文字の "O" です）。
*'''リモート DB:''' このコンジットが同期をとるハンドヘルド上のデータベースの名前です。この値を指定することはオプションです。{{br}}{{br}}これらの値は、実行時に HotSync マネージャがあなたのコンジットの {{goto GetConduitInfo,GetConduitInfo()|C/C++ Sync Suite Reference601/6}} エントリ ポイントを呼び出して {{span style='color:blue;font-family:monospace;',infoType}} に {{span style='color:blue;font-family:monospace;',eRegistrationInfo}} を渡してきたときに、あなたのコンジットが {{span style='color:blue;font-family:monospace;',pOut}} パラメータ経由で HotSync に戻す値です。
{{div_end}}
::NOTE
:::あなたが '''Folder registered''' を選択したとき、コンジット ウィザードはあなたのコンジットの出力パスとファイル名を {{span style='color:blue;font-family:monospace;',C:\Documents and Settings\All Users\Application Data\HotSync\Conduits\$(ProjectName).dll}} にセットします。そのため、あなたがあなたのコンジットをビルドした後、それは自動的にシステム（すべての Windows ユーザ）のために登録され、それ以上のアクションなしに実行される準備が整います。
*9. '''Details''' 下の '''Do not require an application on the device with this conduit's creator ID for this conduit to run''' （このコンジットを実行させるのに、デバイス上にこのコンジットの作成者 ID を持つアプリケーションを要求しない） というラベルを付けられているチェック ボックスを選択します。このクイック スタート ガイドでは、あなたはハンドヘルド上に（訳者補足: 作成者 ID が）一致するアプリケーションを持っています。そのため、このオプションをセットするかどうかは本当は問題になりません。しかしながら、あなたが出荷するコンジットのためには、あなたのコンジットを常に実行させるかどうかを慎重に考慮してください; （訳者補足: コンジットと作成者 ID が一致する）アプリケーションが存在しない場合、あなたのコンジットはユーザが必要としない「みなしご」のデータベースを作成することになるかもしれません。{{br}}この設定で、HotSync マネージャがあなたのコンジットの {{span style='color:blue;font-family:monospace;',GetConduitInfo()}} エントリ ポイントを呼び出して {{span style='color:blue;font-family:monospace;',infoType}} に {{goto eRunAlways,eRunAlways|C/C++ Sync Suite Reference601/6}} を渡したとき、あなたのコンジットは 1 を戻します。
*10. '''Details''' 下の '''Do not display this conduit's name in the HotSync Progress dialog box on the desktop''' （このコンジットの名前をデスクトップ上の HotSync 進捗ダイアログ ボックスに表示しない） というラベルを付けられているチェック ボックスをクリアします。あなたのコンジットの名前をこのダイアログ ボックスに表示させることは、あなたのコンジットが実行されているかどうかを確認する助けになります。{{br}}この設定で、HotSync マネージャがあなたのコンジットの {{span style='color:blue;font-family:monospace;',GetConduitInfo()}} エントリ ポイントを呼び出して {{span style='color:blue;font-family:monospace;',infoType}} に {{goto eDoNotDisplayInConduitListForUser,eDoNotDisplayInConduitListForUser|C/C++ Sync Suite Reference601/6}} を渡したとき、あなたのコンジットは 0 を戻します。
*11. あなたの選択を見直し、'''Finish''' をクリックします。
この時点で、コンジット ウィザードは、プロジェクト ファイル、ソリューション ファイル、ソース ファールを作成しています。VC の中では {{span style='color:blue;font-family:monospace;',MyConduit.vcproj}} プロジェクト ファイルがオープンされていて、あなたが次のステップに進む準備が整っています。
!!{{anchor Step 2: Prepare Palm OS Cobalt Simulator}}ステップ 2: Palm OS Cobalt シミュレータを準備する {{goto top,^TOP^}}
このステップは、どのように CDK のメモ帳移植版 [{{goto 1,1}}] アプリケーションを Palm OS Cobalt シミュレータにインストールするかについて説明します。これはクラシック メモ帳アプリケーションのクラシック データベースではなく拡張データベースを使用するバージョンです。あなたが次のステップでビルドするコンジットは、このアプリケーションによって作成される拡張データベースと同期をとります。
!{{anchor Configure Simulator for a Network HotSync Operation}}ネットワーク HotSync 操作のためにシミュレータをコンフィグレーションする {{goto top,^TOP^}}
このクイック スタート ガイドの後半で、あなたはあなたのコンジット実施を試すために Palm OS Cobalt シミュレータに対してネットワーク HotSync を実行します。しかし、まずあなたはシミュレータをインストールしてコンフィグレーションし、HotSync マネージャをコンフィグレーションしなければなりません。これを行うために、''Conduit Development Utilities Guide'' の {{goto Configuring Simulator for Network Connection,「ネットワーク接続のためのシミュレータのコンフィグレーション」|Conduit Development Utitlities Guide601/8}} のステップに従ってください。
!{{anchor Disable Time-Outs}}タイム-アウトを無効にする {{goto top,^TOP^}}
シミュレータ（とハンドヘルド実機）は、HotSync 実施が短期間で完了しない場合、タイム アウトします - これはあなたのデバッグ セッションを中断します。タイム-アウトを無効にするためには、''Conduit Development Utilities Guide'' の {{goto Disabling Time-outs,「タイム-アウトを無効にする」|Conduit Development Utitlities Guide601/A}} のステップに従ってください。
!{{anchor Install Memo Port on Simulator}}メモ移植版 [{{goto 1,1}}] をシミュレータにインストールする {{goto top,^TOP^}}
CDK は、Palm OS Cobalt ハンドヘルドまたはシミュレータにインストールするための {{span style='color:blue;font-family:monospace;',MemoPort.prc}} ファイルを含みます。同様に、このアプリケーションを Palm OS Cobalt シミュレータで実行するのに必要な {{span style='color:blue;font-family:monospace;',MemoPort.dll}} ファイルも含みます。このアプリケーションをシミュレータにインストールするには以下のステップに従ってください:
*1. {{span style='color:blue;font-family:monospace;',MemoPort.prc}} と {{span style='color:blue;font-family:monospace;',MemoPort.dll}} ファイルは {{span style='color:blue;font-family:monospace;',<CDK>\C++\Win\Samples\GenericConduit\SamplePrc\PalmSim}} にあります。
*2. これらのファイルを Palm OS Cobalt シミュレータの実行形式ファイル（{{span style='color:blue;font-family:monospace;',PalmSim.exe}}）と同じディレクトリにコピーします。
*3. Palm OS Cobalt シミュレータを起動します。
*4. シミュレータ上でコンテキスト メニューを表示するために右クリックして '''Install > Database''' を選択します。
*5. シミュレータのフォルダを開いて {{span style='color:blue;font-family:monospace;',MemoPort.prc}} を選択し、'''Open''' をクリックします。
!{{anchor Create Sample Data with Memo Port}}メモ帳移植版 [{{goto 1,1}}] でサンプル データを作成する {{goto top,^TOP^}}
メモ帳移植版 [{{goto 1,1}}] アプリケーションでいくつかメモを作成します。これにより、HotSync 実施後にあなたはデスクトップ上でこれらのメモを見ることができます。
*6. Palm OS Cobalt シミュレータの中でメモ帳移植版 [{{goto 1,1}}] を起動します。
*7. '''New''' をクリックして短いメモを入力します。望むならさらにいくつかメモを追加します。
!!{{anchor Step 3: Configure the Project Settings and Build the DLL}}ステップ 3: プロジェクト設定のコンフィグレーションし、DLL をビルドする {{goto top,^TOP^}}
このステップでは、あなたはあなたの VC プロジェクトの設定を少し変更して、あなたのコンジット DLL をビルドします。
*1. HotSync マネージャ アイコンが Windows タスクバー（スクリーンの右下）の中に表示されている場合、その HotSync マネージャ アイコンをクリックして {{goto Figure A.3,図 A.3}} のように '''Exit''' をクリックします。{{br}}コンジット ウィザードによって作成されるプロジェクトは、あなたがあなたのコンジットをデバッグするとき、自動的に CDK フォルダの中にある HotSync マネージャを起動します。そのため、HotSync マネージャがすでに実行されている場合、まずはそれを終了します。
{{anchor Figure A.3}}
'''図 A.3 HotSync マネージャの終了'''
{{img hotsyncexit.jpg,style='width:180px;height:233px;'}}
*2. VC の '''Solution Explorer''' の中で '''MyConduit''' プロジェクト（"Solution" ではなく）を選択し、'''Project > Properties''' をクリックします。
*3. '''Configuration Properties''' 下の '''MyConduit Property Pages''' ダイアログ ボックスの中の '''Debugging''' をクリックします。
*4. '''Command Arguments''' ボックスの中で、{{goto Figure A.4,図 A.4}} が示すように以下の HotSync マネージャ コマンド-ライン引数を入力します:{{br}}{{span style='color:blue;font-family:monospace;',-ic}}{{br}}この引数は HotSync マネージャに Conduit Inspector （コンジット検査） - リアル タイムで HotSync マネージャの状態の詳細をログにとる開発者ユーティリティ - を起動させます。これはあなたがコンジットを実行させるための必須項目ではありませんが、あなたのコンジットの問題をデバッグするのを助けてくれます。
*5. '''OK''' をクリックします。
{{anchor Figure A.4}}
'''図 A.4 Property Pages > Debugging への変更'''
{{img qs_projset_debug.jpg,style='width:644px;height:433px;'}}
*6. あなたのコンジットをビルドするために '''Build > Rebuild Solution''' をクリックします。
この時点で、あなたのコンジット（{{span style='color:blue;font-family:monospace;',MyConduit.dll}}）がビルドされます。そして、それはすでに登録されて実行する準備が整っています。なぜなら、それはシステムの {{span style='color:blue;font-family:monospace;',Conduits}} フォルダの中にあり（{{span style='color:blue;font-family:monospace;',C:\Documents and Settings\All Users\Application Data\HotSync\Conduits\MyConduit.dll}}）、そのコンジットの {{goto GetConduitInfo,GetConduitInfo()|C/C++ Sync Suite Reference601/6}} エントリ ポイントは、HotSync マネージャが実行時に {{span style='color:blue;font-family:monospace;',infoType}} に {{span style='color:blue;font-family:monospace;',eRegistrationInfo}} を渡してきたときに、正しく応答するからです。
今やあなたはあなたのコンジットをデバッグする準備が整いました。
!!{{anchor Step 4: Single-step/Debug Your Conduit}}ステップ 4: あなたのコンジットをステップごとに実行する/デバッグする {{goto top,^TOP^}}
このステップでは、あなたがステップごとにコンジット コードを実行してそれをデバッグするための開始点を提供します。この節には以下の内容が含まれます:
*{{goto Start Debugging,デバッグの開始}}
*{{goto Check the Custom Dialog Box,カスタム ダイアログ ボックスのチェック}}
*{{goto Perform a HotSync Operation,HotSync の実行}}
*{{goto Save Conduit Inspector Logs,コンジット検証ログの保存}}
!{{anchor Start Debugging}}デバッグの開始 {{goto top,^TOP^}}
*1. VC で {{span style='color:blue;font-family:monospace;',entrypoints.cpp}} ファイルをオープンして以下のコンジット エントリ関数にブレイクポイントをセットします:
{{div_begin style="margin-left:5em;"}}
*{{span style='color:blue;font-family:monospace;',OpenConduit()}}
*{{span style='color:blue;font-family:monospace;',GetConduitInfo()}}
*{{span style='color:blue;font-family:monospace;',CfgConduit()}}
{{div_end}}
*2. デバッグを開始するために、'''Debug > Start''' を選択します（またはキーボード ショートカットを使用します: F5 を押します）。以下の警告が表示されるかもしれません:{{br}}'HotSync.exe' does not contain debugging information. (No symbols loaded.) Click OK to debug anway. （'HotSync.exe' はデバッグ情報を保持していません。（読み込まれたシンボルがありません。）ともかくデバッグするには OK をクリックしてください。）{{br}}これは通常のことです。ですから '''OK''' をクリックして先に進んでください。
*3. コンジット検証ウィンドウが表示されたとき、サイズと位置を調節して VC の傍らに見えるようにします。リアル タイムで表示されるコンジット検証ログは HotSync マネージャとあなたのコンジットが何をしているのかを表示するたいへん有用なメッセージです。{{goto Figure A.5,図 A.5}} はコンジット検証のオープンされているウィンドウを示しています。{{br}}コンジット検証が開始されない場合、{{goto Figure A.4,図 A.4}} を参照して、示されているようにあなたがプログラム引数をセットしたかどうかを確認してください。
*4. コンジット検証は {{goto Figure A.5,図 A.5}} のような '''HotSync リアルタイム ログ''' を表示します。{{br}}コンジット検証の使用についての詳細は、''Conduit Development Utilities Guide'' の [[第 6 章 「コンジット検証ユーティリティ」|Conduit Development Utilities Guide601/6]] を参照してください。
*5. コンジット検証の開始と同時に、VC は {{span style='color:blue;font-family:monospace;',GetConduitInfo()}} ブレイクポイントに達します。ステップごとに実行させるには F10 を押し、継続させるには F5 を押します。各コンジットに対して HotSync マネージャは何度かこのエントリ ポイントを呼び出します。そのため、HotSync マネージャがコンジットのスタートアップを完了するまでに、あなたは呼び出しのたびに F5 を押さなくてはなりません。{{br}}HotSync マネジャからの "The Notifier file 'filename.dll' was not found," （通知機能ファイル 'filename.dll' は見つかりませんでした。）というアラートが表示される場合、'''OK''' をクリックして無視しても大丈夫です。このアラートを表示させなくするために、あなたは CondCfg ユーティリティを使用してそれらを登録解除するか、hotsync.exe -r を実行して存在しない通知機能の登録を削除することができます。
::NOTE
:::あなたが以前このクイック スタート ガイドを使用していた場合、'''Choose Conduit''' ダイアログ ボックスが表示されます。HotSync マネージャは複数のコンジットが同じ作成者 ID を持たない限りこのダイアログを表示することはありません。実行するコンジットを選択して '''OK''' をクリックします。'''Ignore''' をクリックした場合、HotSync マネージャはあなたのコンジットを実行しません。あなたが選択しなかった紺ジットは {{span style='color:blue;font-family:monospace;',Conduits\Disabled}} フォルダに移されます。
{{anchor Figure A.5}}
'''図 A.5 コンジットと HotSync マネージャが何をしているのかをリアル タイムに表示するコンジット検証'''
{{img qs_cninspect_000.jpg,style='width:455px;height:370px;'}}
!{{anchor Check the Custom Dialog Box}}カスタム ダイアログ ボックスのチェック {{goto top,^TOP^}}
以下のステップは、HotSync マネージャがあなたのコンジットを呼び出してそれの {{span style='color:blue;font-family:monospace;',CfgConduit()}} エントリ ポイントを実行していることを確かめるためのクイック テストです。{{span style='color:blue;font-family:monospace;',CfgConduit()}} エントリ ポイントは、ユーザが HotSync マネージャ メニューの '''Custom''' をクリックして、あなたのコンジットを選択して、'''Change''' をクリックしたときに呼び出されます。以下のステップはあなたのカスタム ダイアログ ボックスをどのようにチェックするかを示しています:
*6. HotSync マネージャ アイコンをクリックして（{{goto Figure A.3,図 A.3}} のように）、'''Custom''' をクリックします。{{br}}'''Custom''' ダイアログ ボックスが表示される前に、VC はあなたのコンジットの {{span style='color:blue;font-family:monospace;',GetConduitInfo()}} エントリ ポイントに達することに注意してください。HotSync マネージャはあなたのフォルダ-登録コンジットに '''Custom''' ダイアログ ボックスに表示する情報を問い合わせます。
*7. HotSync マネージャが {{span style='color:blue;font-family:monospace;',GetConduitInfo()}} を呼び出すたびに F5 を押します。{{br}}HotSync マネージャは何度かこのエントリ ポイントを呼び出した後、{{goto Figure A.6,図 A.6}} のような '''Custom''' ダイアログ ボックスを表示します。
{{anchor Figure A.6}}
'''図 A.6 HotSync マネージャの Custom ダイアログ ボックス'''
{{img qs_hs_custom.jpg,style='width:425px;height:254px;'}}
*8. '''Custom''' ダイアログ ボックスの中の '''MyConduit''' を選択して '''Change''' をクリックします。{{br}}VC の中であなたは {{span style='color:blue;font-family:monospace;',CfgConduit()}} ブレイクポイントに達していることを確認してください。
*9. F5 を押して継続します。{{goto Figure A.7,図 A.7}} のような '''MyConduit (debug)''' ダイアログ ボックスが表示されます。このダイアログ ボックスは、ユーザが一時的または永久的にこのコンジットの同期設定を変更することを可能にします。
*10. すべての HotSync マネージャ ダイアログ ボックス - '''MyConduit (debug)''' と '''Custom''' - を終了します。
これで、HotSync マネージャはあなたのコンジットを呼び出して、それの {{span style='color:blue;font-family:monospace;',CfgConduit()}} エントリ ポイントを実行することを確認しました。
{{anchor Figure A.7}}
'''図 A.7 コンジットの同期設定ダイアログ ボックス'''
{{img qs_hs_changehsaction.jpg,style='width:399px;height:331px;'}}
!{{anchor Perform a HotSync Operation}}HotSync の実行 {{goto top,^TOP^}}
*11. あなたがまだ開始していない場合、Palm OS Cobalt シミュレータを開始します。
*12. シミュレータで '''HotSync''' クライアント アプリケーションを開始します。
*13. HotSync クライアントで '''Network''' ボタンをクリックします。
*14. HotSync クライアントで '''HotSync''' ボタンをクリックします。{{br}}VC の中で、あなたは {{span style='color:blue;font-family:monospace;',GetConduitInfo()}} ブレイクポイントに達することを確認してください。{{br}}コンジット検証がリアル タイム ログ ウィンドウをオープンしてこの HotSync 実施の詳細をログに追加することに注目します。{{br}}HotSync 進捗ダイアログ ボックスが少しの間表示されます。
::NOTE
:::HotSync マネージャが応答して表示されない場合は、{{goto Configure Simulator for a Network HotSync Operation,ネットワーク HotSync 実施のためのシミュレータのコンフィグレーション}} を参照してあなたが正しくシミュレータと HotSync マネージャをセット アップしたかどうかを確認してください。
*15. VC の中で、継続するために F5 を押します。HotSync マネージャはあなたのコンジットの {{span style='color:blue;font-family:monospace;',GetConduitInfo()}} エントリ ポイントを何度か呼び出します。そのたびに F5 を押します。{{br}}あなたが以前シミュレータ セッションで HotSync を実行したことがない場合、'''Create or Select HotSync User''' ダイアログ ボックスが表示されます。実行したことがある場合は、ステップ {{goto step 17,17}} にスキップしてください。
*16. HotSync ユーザ アカウントを作成するかすでに存在しているものを選択して '''OK''' をクリックします。{{br}}HotSync は継続されます。VC の中で、あなたは {{span style='color:blue;font-family:monospace;',GetConduitInfo()}} エントリ ポイントに再び達することに注意してください。
*17. {{span style='color:blue;font-family:monospace;',GetConduitInfo()}} エントリ ポイントから継続するために F5 を押します。VC の中で、あなたは {{span style='color:blue;font-family:monospace;',OpenConduit()}} エントリ ポイントに達します。
*18. {{span style='color:blue;font-family:monospace;',OpenConduit()}} から継続するために F5 を押します。{{br}}HotSync 実行は終了します。コンジット検証は HotSync 実施中に HotSync マネージャとすべてのコンジットがしたことをログにとっています。
*19. この時点で、あなたはデバッグを続けるか終了することができます。VC でデバッグ終了するには、'''Debug > Stop Debugging''' をクリックします。{{br}}コンジット検証はあなたが使用するためにオープンされたままだが、HotSync マネージャは終了していることに注目してください。
::NOTE
:::デバッグ セッションの終了後、HotSync マネージャは確かに終了しています。しかしながら、HotSync マネージャのアイコンは、あなたがポインタをその上に持っていくまで、Windows のタスクバーに表示されています。
!{{anchor Save Conduit Inspector Logs}}コンジット検証ログの保存 {{goto top,^TOP^}}
いずれかの時点で、あなたのコンジット検証ログ ファイルを後で閲覧するために保存します。
*20. オープンされている '''HotSync Realtime Log''' ウィンドウを選択して、ログ ファイルを保存するために '''File > Sabe As''' を選択します。
*21. 他のログ ウィンドウが表示されている場合、それらも同様に保存します。
あなたがデバッグを終了したとき、あなたはあなたのコンジットの設定をあなたが開始したときの設定に戻すための次のステップに進むことができます。
!!{{anchor Examine the MyConduitData.xml File}}MyConduit.xml ファイルを検証する {{goto top,^TOP^}}
あなたが前のステップで HotSync を実行したとき、あなたのコンジットはシミュレータ上の MemoDB データベースとデスクトップの以下の場所にある XML ファイルの同期をとっています:
{{span style='color:blue;font-family:monospace;',C:\Documents and Settings\<Windows User>\My Documents\Palm OS Desktop\<HotSync User>\MyConduit\MyConduitData.xml}}
このファイルをお好みの XML エディタでオープンして、あなたがシミュレータの中で作成したメモ（{{goto Create Sample Data with Memo Port,「メモ帳移植版でサンプルのメモを作成する」}}）があることを確認します。
さらに検証を行うため、{{span style='color:blue;font-family:monospace;',MyConduitData.xml}} ファイルを編集して、HotSync を実行して、シミュレータのメモ帳移植版 [{{goto 1,1}}] アプリケーションが変更されていることを確認します。
::NOTE
:::あなたが XML ファイルの中のデータを変更するとき、"Modified" フラグをセットすることを忘れないでください。さもなければ、Generic Coduit Framework の同期ロジックは変更が行われたことに気付かず、その変更をデータベースに転送しません。
{{anchor 1}}
[1]: 原文では "Memo Port"、Port は「移植（Cobalt へ）」を意味するのか、それとも「データの受け渡しをする」ということを意味するのか？
{{div_end}}
{{div_begin "style='border-top-style:solid;border-top-width:1px;border-top-color:silver;'"}}
[[← 9 章に戻る|C/C++ Sync Suite Companion601/9]] [[↑トップへ|C/C++ Sync Suite Companion601]]
{{div_end}}
