{{div_begin}}
[[←　0 章に戻る|C/C++ Sync Suite Companion601/0]]　[[↑トップへ|C/C++ Sync Suite Companion601]]　[[2 章に進む　→|C/C++ Sync Suite Companion601/2]]
{{div_end}}

{{div_begin style="margin-bottom:-10px"}}
!!!1 C API-ベース コンジット入門
{{div_end}}

{{div_begin "style='position:absolute;right:0px;font-size:70%;margin-right:15px;margin-top:15px;width:250px;'"}}
*{{goto Definition of Conduit,コンジットの定義}}
*{{goto C/C++ Sync Suite Contents,C/C++ Sync Suite のコンテンツ}}
**{{goto Overview,概要}}
**{{goto Top-Level Directories,Top-Level ディレクトリ}}
**{{goto Samples Directory,サンプル ディレクトリ}}
{{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;'"}}
この章は C/C++ Sync Suite を紹介します。コンジットのコンセプト、コンジットを開発するためにあなたは何を必要とするのか、C/C++ Sync Suite は何を提供するのかについて説明します。

この章は以下の節に分かれています:

*{{goto Definition of Conduit,コンジットの定義}}
*{{goto C/C++ Sync Suite Contents,C/C++ Sync Suite のコンテンツ}}

'''NOTE:''' コンジットとコンジットを開発するのに使用できるいくつかの異なる言語についての更なる予備知識は、[[Introduction to Conduit Development|Introduction to Conduit Development601]] を参照してください。


!!{{anchor Definition of Conduit}}コンジットの定義 {{goto top,^TOP^}}

'''コンジット'''は、Palm ハンドヘルド上のアプリケーションのデータとデスクトップ アプリケーションまたはネットワーク データベースのデータとの同期をとる - 必要があれば 2 つのデータ間でデータ フォーマットの変換を行いながら - HotSync マネージャ アプリケーションのためのプラグ-イン モジュールです。HotSync マネージャはコンジットを実行します。コンジットは、ユーザがハンドへルドをクレドルに置いて HotSync ボタンを押したとき、ユーザのデスクトップ コンピュータにインストールされます{{fn HotSync マネージャは、赤外線、モデム、ローカル エリア ネットワーク経由の接続もサポートします。}}。コンジットは通常、指定されたハンドヘルド アプリケーション データベースからのデータの同期またはバック アップをとるように設計されます。あなたは PalmSource 社が提供する Windows のための Palm OS Conduit Development Kit (CDK) を形成しているスイートのいずれかでコンジットを開発することができます（''Introductioin to Conduit Development'' の中の [[コンジットの開発|Introduction to Conduit Development601/10]] を参照してください）。

'''C API-ベース コンジット'''は、C/C++ Sync Suite で作成される Windows DLL です。Windows システム上で実行されている各 C API-ベース コンジットは、標準ダイナミック リンク ライブラリ（DLL）です。あなたのコンジット コードは他のいずれかの DLL が実行できるアクションを実行します。しかしながら、HotSync プロセスの整合性を保つために、コンジットは ''Introduction to Conduit Development'' の中の {{goto Conduit Design Philosophy,コンジット設計の原理|Introduction to Conduit Development601/4}} で説明されているある特定の設計目標に適合する必要があります。

'''NOTE:''' あなたはあなたの C API-ベース コンジットを標準 DLL としてビルドしなければなりません。拡張 DLL としてビルドしないでください。

C/C++ Sync Suite で開発されたコンジットのいずれかを、Palm OS プラットフォーム ライセンシ（ライセンスを受けた人）によって開発されたハンドヘルドを含むいずれかの Palm ハンドヘルドに接続するために使用することができます。

コンジットはデスクトップ アプリケーションまはた Windows デスクトップ コンピュータ上で実行されている他のシステム アプリケーションと Palm ハンドヘルド上で実行されているアプリケーションとの間でデータの交換と同期を行います。これを行うために、ユーザは以下のステップを実行しなければなりません:

+Palm OS デスクトップ ソフトウェアまたは Palm OS ライセンシから提供される他のデスクトップ アプリケーションをインストールする。このソフトウェアは HotSync マネージャを含みます。
+ハンドヘルドと共に提供されたインストール ドキュメントの説明に従ってクレドルをインストールする。
+ハンドヘルドをクレドルに挿入する（または他の接続タイプ経由で）。
+クレドル上の HotSync ボタンを押す（またはハンドヘルドの上の HotSync クライアント アプリケーションを開始して、ディスプレイ上の HotSync ボタンをタップする）。

HotSync マネージャは、アプリケーションのために設計されたコンジットを実行することによって各アプリケーションの同期をとります。HotSync マネージャは、例えもしコンジットが異なる言語 - 例えば、C/C++ と Java - で書かれていた場合であっても、同じ同期セッションの中で多くのコンジットを実行することができます。

多くのコンジット（Palm ハンドヘルドにビルト-インされている 4 つの最もポピュラーなアプリケーションのためのコンジットを含む）は、ハンドヘルドとデスクトップ コンピュータとの間で同期をとり、それにより同期後にそれらはミラー イメージとなります（訳者注: ハンドヘルドとデスクトップ コンピュータが同じデータを持つということ）。他のコンジットは更に複雑な操作を実行します。あなたのコンジットの動作の複雑さが開発にかかる労力を決定します。

{{footnote_list}}


!!{{anchor C/C++ Sync Suite Contents}}C/C++ Sync Suite のコンテンツ {{goto top,^TOP^}}

この節は、C/C++ Sync Suite のコンテンツについて説明します。

*{{goto Overview,概要}}
*{{goto Top-Level Directories,Top-Level ディレクトリ}}
*{{goto Samples Directory,サンプル ディレクトリ}}


!{{anchor Overview}}概要 {{goto top,^TOP^}}

C/C++ Sync Suite は PalmSource 社が提供する Windows のための Palm OS Conduit Development Kit (CDK) の一部です。C/C++ Sync Suite は、あなたがハンドヘルド ユーザ データにアクセスする C API-ベース コンジットとデスクトップ アプリケーションを開発するのに必要とする以下のファイル、ドキュメント、ライブラリ、サンプル コードを提供します:

*'''ドキュメント''' - ''Introduction to Conduit Development'', ''Conduit Development Utilities Guide'', ''C/C++ Sync Suite Companion'', ''C/C++ Sync Suite Referene'' を含みます。{{goto Related Documentation,関連ドキュメント|C/C++ Sync Suite Companion601/0}} を参照してください。
*'''C API のためのライブラリとヘッダ ファイル''' - あなたが C/C++ Sync Suite で開発するプロジェクトをコンパイルするのに必要なライブラリとヘッダ ファイル。
*''Palm Foundation Classes''' - 多くのサンプルと C/C++ Sync Suite の中で提供される API によって使用されるデスクトップ クラス。
*'''Generic Conduit Framework''' - C++ でかかれた Generic コンジットをビルドする間にあなたが参照することができるベース クラス。2 つのフレームワークが提供されます: 1 つは {{goto classic database,クラシック データベース|Introduction to Conduit Development601/Glossary}} の同期をとるためのものであり、もう 1 つは {{goto extended database,拡張データベース|Introduction to Conduit Development601/Glossary}} の同期をとるためのものです。
*'''XML コンジット サンプル コード''' - Generic Conduit Framwork をベースにしたサンプル。拡張データベースとデスクトップ上の XML ファイルとの同期をとります。
*'''コンジット開発ユーティリティ''' - あなたがコンジットを開発、デバッグするのを助けるいくつかの不可欠なツール。これらは、すばやく機能的なコンジットを作成するコンジット ウィザードとあなたのコンジットを HotSync マネージャに登録するコンジット コンフィグレーション ユーティリティを含みます。


!{{anchor Top-Level Directories}}Top-Level ディレクトリ {{goto top,^TOP^}}

インストール時に C/C++ Sync Suite のために以下のディレクトリ構造があなたのシステム上に作成されます。

*{{span style='color:blue;font-family:monospace;',<CDK>\Common\Bin}}
**HotSync マネージャ、サポート DLL、コンジット開発ユーティリティを保持します。
*{{span style='color:blue;font-family:monospace;',<CDK>\Common\Docs}}
**HTML Help フォーマットのすべての CDK ドキュメントを保持します。ドキュメントは Visual Studio .NET でも統合されるということに注意してください。
*{{span style='color:blue;font-family:monospace;',<CDK>\C++\Common}}
**拡張 Generic Conduit Framework のための共通のソースとヘッダ ファイル。
*{{span style='color:blue;font-family:monospace;',<CDK>\C++\Win}}
**Windows 用のソース、ヘッダ、ライブラリ、サンプル ファイル。


!{{anchor Samples Directory}}サンプル ディレクトリ {{goto top,^TOP^}}

より容易に開発を始めるために、C/C++ Sync Suite は、あなたの要求に合わせてあなたがカスタマイズできるいくつかのサンプルを含んでいます。以下のすべてのディレクトリは {{span style='color:blue;font-family:monospace;',<CDK>\C++\Win\Samples}} の中にあります。

*{{span style='color:blue;font-family:monospace;',GenericConduit\}}
**{{span style='color:blue;font-family:monospace;',Base\}}
***拡張データベースのためのベース Generic Conduit Framework。
**{{span style='color:blue;font-family:monospace;',Classic\}}
***クラシック データベースのための Generic Conduit Framework。{{span style='color:blue;font-family:monospace;',PFC_OLD}} サブフォルダはクラシック データベース用の PFC ソースとヘッダ ファイルを保持しているということに注意してください。
**{{span style='color:blue;font-family:monospace;',SamplePrc\}}
***クラシック データベースではなく拡張データベースを使用するメモ帳アプリケーションの移植バージョン（原文: ported version。port は「移植」を意味するのか、それとも「データの受け渡し」を意味するのか？）。あなたはこのアプリケーションを使って拡張 Generic Conduit Framework の実験を行うことができます。サブフォルダは Palm OS Cobalt ハンドヘルドと Palm OS Cobalt シミュレータのためのバージョンを保持しています。
**{{span style='color:blue;font-family:monospace;',XML\}}
***デスクトップ上の XML ファイルと同期をとる拡張 Generic Conduit Framework のサブクラス化されたバージョン。

*{{span style='color:blue;font-family:monospace;',MSVC.NET 7.0 Wizard\}}
**VC .NET 2002 のためのコンジット ウィザード ファイル。

*{{span style='color:blue;font-family:monospace;',MSVC.NET 7.1 Wizard\}}
**VC .NET 2003 のためのコンジット ウィザード ファイル。{{br}}CDK のインストーラが VC .NET がインストールされているのを検知した場合、自動的にコンジット ウィザードの適切なバージョンをインストールします。{{span style='color:blue;font-family:monospace;',Samples}} フォルダにインストールしないコンジット ウィザードのバージョンのみをおきます。''Conduit Development Utilities Guide'' の中の {{goto Installing the Conduit Wizard,コンジット ウィザードのインストール|Conduit Development Utilities Guide/0}} を参照してください。{{br}}（訳者: VC .NET 2005 でこのウィザードを実行する方法をご存知の方は是非教えてください。）

*{{span style='color:blue;font-family:monospace;',PDNotify\}}
**[[デスクトップ アプリケーション通知機能 API|C/C++ Sync Suite Reference601/18]] を使って HotSync マネージャ経由で Palm OS デスクトップ ソフトウェアと通信する通知機能のための C ソース コード。

*{{span style='color:blue;font-family:monospace;',UserDataApp\}}
**デスクトップ ユーザ情報を閲覧、変更するための [[ユーザ データ API|C/C++ Sync Suite Reference601/16]] を呼び出す小さなアプリケーションのための C++ ソース コード。ビルド前の実行可能ファイルは {{span style='color:blue;font-family:monospace;',<CDK>\Common\Bin}} フォルダの中でも提供されます。
{{div_end}}

{{div_begin "style='border-top-style:solid;border-top-width:1px;border-top-color:silver;'"}}
[[←　0 章に戻る|C/C++ Sync Suite Companion601/0]]　[[↑トップへ|C/C++ Sync Suite Companion601]]　[[2 章に進む　→|C/C++ Sync Suite Companion601/2]]
{{div_end}}