- 追加された行はこのように表示されます。
- 削除された行は
このように表示されます。
{{div_begin}}
[[← 目次に戻る|C/C++ Sync Suite Reference601/TOC]] [[↑トップへ|C/C++ Sync Suite Reference601]] [[パート I に進む →|C/C++ Sync Suite Reference601/I]]
{{div_end}}
{{div_begin style="margin-bottom:-10px"}}
!!!0 本書について
{{div_end}}
{{div_begin "style='position:absolute;right:0px;font-size:70%;margin-right:15px;margin-top:15px;width:250px;'"}}
*{{goto Related Documentation,関連ドキュメント}}
*{{goto What this Document Contains,本書に書かれていること}}
*{{goto Changes to This Document,本書の変更点}}
**{{goto Document 3012-006 for CDK 6.0.1,CDK 6.0.1 のためのドキュメント 3012-006}}
**{{goto Document 3012-005 for CDK 6.0,CDK 6.0 のためのドキュメント 3012-005}}
**{{goto Document 3012-004 for CDK 6.0,CDK 6.0 のためのドキュメント 3012-004}}
*{{goto Additional Resources,追加リソース}}
*{{goto Convention Used in this Document,本書の慣習}}
{{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 は、PalmSource 社が提供する Windows のための Palm OS Conduit Development Kit (CDK) のコンポーネントの 1 つです。これは、開発者が Windows コンピュータ上で実行される C API ベース コンジットを作成するのを助けるために API、C++ Generic Conduit Framework、サンプル、ドキュメント、ユーティリティを提供します。Palm OS プラットフォームの成功への鍵である'''コンジット'''は、デスクトップ コンピュータ上で実行されているアプリケーションと Palm ハンドヘルド間でデータの交換と同期を行うソフトウェア オブジェクトです。
この ''C/C++ Sync Suite Reference'' は、あなたがコンジットを開発するために使用できるすべての定数、データ構造体、クラス、関数、メソッドのための完全な参照情報を提供します。
この導入部は以下のパートに分かれています。
*{{goto Related Documentation,関連ドキュメント}}
*{{goto What this Document Contains,本書に書かれていること}}
*{{goto Changes to This Document,本書の変更点}}
*{{goto Additional Resources,追加リソース}}
*{{goto Convention Used in this Document,本書の慣習}}
!!{{anchor Related Documentation}}関連ドキュメント {{goto top,^TOP^}}
ここに書かれているドキュメントの最新バージョンは、以下の URL で見つけることができます。
http://www.palmos.com/dev/support/docs/
以下のドキュメントは CDK の一部です:
,ドキュメント,説明
,[[Introduction to Conduit Development|Introduction to Conduit Development601]],Windows プラットフォームでのコンジットの導入。コンジットが Palm OS プラットフォームの他の側面とどのように関係するのか、コンジットがどのように HotSync マネージャと通信するのか、どのようにコンジット開発へのアプローチを選択するのかを説明しています。新たにコンジットを開発する開発者が読むことをお勧めします。
,[[C/C++ Sync Suite Companion|C/C++ Sync Suite Companion601]],C API-ベース コンジットがどのように機能するのか、どのように C/C++ Sync Suite でそれらを開発するのかの概要。
,[[C/C++ Sync Suite Reference|C/C++ Sync Suite Reference601]],C/C++ Sync Suite でコンジットを開発するために使用されるすべてのコンジット関数呼び出しと重要なデータ構造体についての C API リファレンス。
,[[COM Sync Suite Companion]],COM ベースのコンジットがどのように機能するのか、COM Sync Suite を使ってどのようにそれらのコンジットを開発するのかについての概要。
,[[COM Sync Suite Reference]],COM Sync Suite オブジェクトの階層、各オブジェクト、メソッド、プロパティの詳細についてのリファレンス。
,[[Conduit Development Utilities Guide]],開発者が Windows 用のコンジットを作成、デバッグするのを助ける CDK ユーティリティのガイド。
!!{{anchor What this Document Contains}}本書に書かれていること {{goto top,^TOP^}}
ここでは本書の主要なパートと各章ごとの概観を提供します。
*[[パート I 「同期マネージャ API」|C/C++ Sync Suite Reference601/I]] コンジットだけが HotSync の最中に 3 つの異なるタイプの Palm OS データベースの 1 つとあなたのデスクトップ データ ソースとを同期させるために呼び出すことができる同期マネージャ API について説明します。
**[[第 1 章 「同期マネージャ API の概要」|C/C++ Sync Suite Reference601/1]] 同期マネージャ API が個々のヘッダ ファイルの中でどのように宣言されているかについて説明します。各ヘッダ ファイルは各データベース タイプのためのものであり、そこに含まれる API はそれぞれのタイプのデータベースに対して機能します。
**[[第 2 章 「スキーマ同期マネージャ API」|C/C++ Sync Suite Reference601/2]] スキーマ Palm OS データベースのための同期マネージャ関数、定数、クラス、データ構造体について説明します。
**[[第 3 章 「拡張同期マネージャ API」|C/C++ Sync Suite Reference601/3]] 拡張 Palm OS データベースのための同期マネージャ関数、定数、クラス、データ構造体について説明します。
**[[第 4 章 「クラシック同期マネージャ API」|C/C++ Sync Suite Reference601/4]] クラシック Palm OS データベースのための同期マネージャ関数、定数、クラス、データ構造体について説明します。
**[[第 5 章 「共通同期マネージャ API」|C/C++ Sync Suite Reference601/5]] すべてのタイプのデータベースのために使用されるか、データベース タイプに依存しない同期マネージャ関数、定数、クラス、データ構造体について説明します。
*[[パート II 「コンジット API」|C/C++ Sync Suite Reference601/II]] コンジットだけが HotSync の最中に呼び出せるコンジット エントリ ポイントと他の API について説明します。
**[[第 6 章 「コンジット エントリ ポイント API」|C/C++ Sync Suite Reference601/6]] コンジット API 関数 - これらは、あなたのコンジットが HotSync マネージャ アプリケーションと通信するために実装しなければならない関数です - について説明します。
**[[第 7 章 「HotSync ログ API」|C/C++ Sync Suite Reference601/7]] HotSync ログ関数 - これは、あなたが HotSync ログにアクセスするために使用することができます - について説明します。
**[[第 8 章 「Palm OS 一般言語 API」|C/C++ Sync Suite Reference601/8]] コンジットが言語リソース DLL をロード、アンロードできるようにするためにあなたが使用可能な Palm OS 一般言語 API について説明します。
**[[第 9 章 「拡張マネージャ API」|C/C++ Sync Suite Reference601/9]] あなたがハンドヘルドの中にある拡張カードについての情報を取得するために使用できる拡張マネージャ関数、定数、データ構造体について説明します。
**[[第 10 章 「仮想ファイル システム マネージャ API」|C/C++ Sync Suite Reference601/10]] あなたがハンドヘルドの中にある拡張カード上のファイル システムにアクセスするために使用できる VFS マネージャ関数、定数、データ構造体について説明します。
*[[パート III 「デスクトップ サポート API」|C/C++ Sync Suite Reference601/III]] デスクトップ アプリケーションとインストーラが呼び出せる - 通常は HotSync の最中でないときに - API について説明します。しかしながら、それらのいくつかは HotSync の最中にコンジットによって呼び出される可能性があります。
**[[第 11 章 「コンジット マネージャ API」|C/C++ Sync Suite Reference601/11]] あなたがあなたのコンジットをインストールまたはアンインストールするために使用できるコンジット マネージャ関数、定数、データ構造体について説明します。
**[[第 12 章 「インストール コンジット マネージャ API」|C/C++ Sync Suite Reference601/12]] あなたがあなたのインスール コンジットをインストールまたはアンインストールするために使用できるインストール コンジット マネージャ関数、定数、データ構造体について説明します。
**[[第13 章 「通知機能インストール マネージャ API」|C/C++ Sync Suite Reference601/13]] あなたがあなたのデスクトップ通知機能をインストールまたはアンインストールするために使用できる通知機能インストール マネージャ関数、定数、データ構造体について説明します。
**[[第 14 章 「HotSync マネージャ API」|C/C++ Sync Suite Reference601/14]] あなたが HotSync マネージャの基本的な機能 (開始、停止、など) を制御するために使用できる HotSync マネージャ API について説明します。
**[[第 15 章 「インストール援助機能 API」|C/C++ Sync Suite Reference601/15]] あなたがデスクトップからアプリケーションとデータベースをハンドヘルドのメイン メモリにインストールするため、ファイルを拡張カードにインストールするために使用できる関数について説明します。
**[[第 16 章 「ユーザ データ API」|C/C++ Sync Suite Reference601/16]] あなたがデスクトップ コンピュータとの同期を行ったユーザについての情報にアクセスするために使用できるユーザ データ関数について説明します。
**[[第 17 章 「パスワード ライブラリ」|C/C++ Sync Suite Reference601/17]] あなたがパスワードを検証するために使用できるパスワード ライブラリについて説明します。
**[[第 18 章 「デスクトップ アプリケーション通知機能 API」|C/C++ Sync Suite Reference601/18]] デスクトップ アプリケーション通知機能の API について説明します。あなたの通知機能はこの API を実装し、それによって HotSync マネージャはその通知機能のメッセージを HotSync の開始時と終了時に送信できるようになります。
*[[パート IV 「付録」|C/C++ Sync Suite Reference601/IV]] すべての C/C++ 関数とエラー コードの要約を提供します。
**[[付録 A 「改訂履歴」|C/C++ Sync Suite Reference601/A]] Windows のための CDK の各リリースでの C/C++ Sync Suite の中にある API への変更の詳細。
**[[付録 B 「プライベート関数と古い関数」|C/C++ Sync Suite Reference601/B]] あなたがソース コードの中で見つけるかもしれないが、あなたのコンジットの中では使用できないプライベート システム関数の要約。
!!{{anchor Changes to This Document}}本書の変更点 {{goto top,^TOP^}}
ここでは本書の各バージョンで行われた主要な変更について説明します。CDK の各バージョンでの C/C++ Sync Suite API への追加、変更については、[[付録 A 「改訂履歴」|C/C++ Sync Suite Reference601/A]] を参照してください。
*{{goto Document 3012-006 for CDK 6.0.1,CDK 6.0.1 のためのドキュメント 3012-006}}
*{{goto Document 3012-005 for CDK 6.0,CDK 6.0 のためのドキュメント 3012-005}}
*{{goto Document 3012-004 for CDK 6.0,CDK 6.0 のためのドキュメント 3012-004}}
!{{anchor Document 3012-006 for CDK 6.0.1}}CDK 6.0.1 のためのドキュメント 3012-006 {{goto top,^TOP^}}
このドキュメント バージョンでの主要な修正と追加は以下に章ごとにリストアップされています:
*[[第 4 章 「クラシック同期マネージャ API」|C/C++ Sync Suite Reference601/4]]
**{{goto CCallModuleParams,CCallModuleParams|C/C++ Sync Suite Reference601/4-1}} と {{goto SyncCallRemoteModule,SyncCallRemoteModule()|C/C++ Sync Suite Reference601/4-1}} はクラシック データベースに対してのみ機能するため、それを反映させるためにこの章に移動しました。
**{{goto SyncReadAppPreference,SyncReadAppPreference()|C/C++ Sync Suite Reference601/4-2}} と {{goto SyncWriteAppPreference,SyncWriteAppPreference()|C/C++ Sync Suite Reference601/4-2}} は Palm OS Cobalt ハンドヘルドと Palm OS Garnet ハンドヘルドの両方に対して機能する関数であるという説明を追加しました。
*[[第 5 章 「共通同期マネージャ API」|C/C++ Sync Suite Reference601/5]]
**{{goto CSystemInfo,CSystemInfo|C/C++ Sync Suite Reference601/5-1}} に HotSync マネージャ バージョン 6.0 以降はハンドヘルドの Palm OS バージョン番号をデスクトップ上のユーザ データ保存場所に保存するという注意書きを加えました。
*[[第 7 章 「HotSync ログ API」|C/C++ Sync Suite Reference601/7]]
**{{goto Activity,Activity}} に {{span style='color:blue;font-family:monospace;',slSyncFinished}} と {{span style='color:blue;font-family:monospace;',slSyncStarted}} は HotSync 全体ではなくコンジットの同期セッションを参照するという注意書きを加えました。
*[[第 16 章 「ユーザ データ API」|C/C++ Sync Suite Reference601/16]]
**{{goto UmGetInteger,UmGetInteger()|C/C++ Sync Suite Reference601/16}} にユーザ データ保存場所からどのようにハンドヘルドの Palm OS バージョン番号を取得するかについての説明を加えました。
*「ファイル リンク API」という章は、その機能が HotSync マネージャ 6.0.1 ではサポートされなくなったために、削除されました。
*[[付録 A 「改訂履歴」|C/C++ Sync Suite Reference601/A]] 以下の節が追加されました。
**{{goto Changes in C/C++ Sync Suite 6.0.1,C/C++ Sync Suite 6.0.1 での変更点}}
**{{goto Changes in C/C++ Sync Suite 6.0a,C/C++ Sync Suite 6.0a での変更点}}
!{{anchor Document 3012-005 for CDK 6.0}}CDK 6.0 のためのドキュメント 3012-005 {{goto top,^TOP^}}
主要な変更は以下に章ごとにリストアップされています:
*[[第 2 章 「スキーマ同期マネージャ API」|C/C++ Sync Suite Reference601/2]]
**{{goto Table Column Data Types,「テーブル行データ タイプ」|C/C++ Sync Suite Reference601/2}} の中の日付と時刻データについての詳細を追加しました。
**{{goto SyncDbCreateRow,SyncDbCreateRow()|C/C++ Sync Suite Reference601/2}} に列値を持たない行を作成する方法についての説明を追加しました。
**{{goto SyncDbCreateRows,SyncDbCreateRows()|C/C++ Sync Suite Reference601/2}} にコンジットはリストアの最中にだけ行 ID を指定できるということを追加しました。
**{{goto SyncDbRemoveTable,SyncDbRemoveTable()|C/C++ Sync Suite Reference601/2}} にこの関数は非デフォルトのソート インデックスを保持するテーブルを削除することはできないということを追加しました。
**{{goto SyncDbWriteRows,SyncDbWriteRows()|C/C++ Sync Suite Reference601/2}} に行のカテゴリ帰属を削除する方法についての説明を追加しました。
*[[第 3 章 「拡張同期マネージャ」|C/C++ Sync Suite Reference601/3]]
**各関数が返す可能性のあるエラー コードのリストを修正しました。
**{{goto SyncDmReadNextModifiedRecord,SyncDmReadNextModifiedRecord()|C/C++ Sync Suite Reference601/3}} に反復ポインタを進めずにキャッシュの中にある味読のデータを取得する方法についての説明を追加しました。
*[[第 4 章 「クラシック同期マネージャ API」|C/C++ Sync Suite Reference601/4]]
**{{goto eFirstSync,eFirstSync|C/C++ Sync Suite Reference601/4-1}} 列挙値の意味を明記しました。
**{{goto SyncCallRemoteModule,SyncCallRemoteModule()|C/C++ Sync Suite Reference601/4-1}} 呼び出しの結果が稀に不確定になるということを追加しました。
**{{goto SyncReadSysDateTime,SyncReadSysDateTime()|C/C++ Sync Suite Reference601/4-2}} と {{goto SyncWriteSysDateTime,SyncWriteSysDateTime()|C/C++ Sync Suite Reference601/4-2}} に日付と時刻を提供するためのフォーマットについての説明を追加しました。
*[[第 10 章 「仮想ファイル システム マネージャ API」|C/C++ Sync Suite Reference601/10]]
**{{goto VFSExportDatabaseToFile,VFSExportDatabaseToFile()|C/C++ Sync Suite Reference601/10}} と {{goto VFSImportDatabaseFromFile,VFSImportDatabaseFromFile()|C/C++ Sync Suite Reference601/10}} はスキーマ データベースに対しては機能しないという注意書きを追加しました。
*[[第 14 章 「HotSync マネージャ API」|C/C++ Sync Suite Reference601/14]]
**HotSync マネージャ バージョン 6.0 以降に新たに登録されたコンジットを認識させるために {{goto HsRefreshConduitInfo,HsRefreshConduitInfo()|C/C++ Sync Suite Reference601/14}} または {{goto HsSetAppStatus,HsSetAppStatus()|C/C++ Sync Suite Reference601/14}} を呼び出す必要はないという注意書きを追加しました。
!{{anchor Document 3012-004 for CDK 6.0}}CDK 6.0 のためのドキュメント 3012-004 {{goto top,^TOP^}}
このドキュメント バージョンでの大半の変更点は同期マネージャ バージョン 2.4 (HotSync マネージャ 6.0) に追加された新しい機能についてです。これらと他の変更点は以下に章の順番にリストアップされています:
*[[第 1 章 「同期マネージャ API の概要」|C/C++ Sync Suite Reference601/1]] この章が追加されました。
*[[第 2 章 「スキーマ同期マネージャ API」|C/C++ Sync Suite Reference601/2]] この章が追加されました。
*[[第 3 章 「拡張同期マネージャ API」|C/C++ Sync Suite Reference601/3]] この章が追加されました。
*[[第 4 章 「クラシック同期マネージャ API」|C/C++ Sync Suite Reference601/4]] この章を {{span style='color:blue;font-family:monospace;',Sync*.h}} ヘッダ ファイルと整合するように再編成しました。
*[[第 5 章 「共通同期マネージャ API」|C/C++ Sync Suite Reference601/5]] この章が追加されました。
*[[第 7 章 「HotSync ログ API」|C/C++ Sync Suite Reference601/7]]
**{{goto HotSync Log API Changes,「HotSync ログ API の変更点」|C/C++ Sync Suite Reference601/A}} で説明されているこの API の変更点についてドキュメント化しました。
**{{goto LogAddFormattedEntry,LogAddFormattedEntry()|C/C++ Sync Suite Reference601/7}} のバグをドキュメント化しました。
*第 9 章 「ファイル リンク API」
**{{span style='color:blue;font-family:monospace;',SubDupSubscCategory()}} が返す可能性のある値のリストから {{span style='color:blue;font-family:monospace;',CATEGORY_REGULAR}} を削除しました。この関数は指定されたカテゴリ名がファイル リンク カテゴリとして使用中であるかどうかだけを決定し、カテゴリが存在するかどうかは決定しません。
*[[第 11 章 「コンジット マネージャ API」|C/C++ Sync Suite Reference601/11]]
**{{goto "Conduit Manager API, Version 3 Changes","「コンジット マネージャ API, バージョン 3 の変更点」|C/C++ Sync Suite Reference601/A"}} で説明されているこの API の変更点をドキュメント化しました。
**コンジット コンフィグレーション エントリの定義を ''Introduction to Conduit Development'' の [[付録 A 「コンフィグレーション エントリ」|Introduction to Conduit Development601/A]] に移動しました。
*[[第 12 章 「インストール コンジット マネージャ API」|C/C++ Sync Suite Reference601/12]]
**{{goto "Install Conduit Manager API, Version 3 Changes","「インストール コンジット マネージャ API, バージョン 3 の変更点」|C/C++ Sync Suite Reference601/A"}} で説明されているこの API の変更点をドキュメント化しました。
**{{goto ImUnregisterID,ImUnregisterID()|C/C++ Sync Suite Reference601/12}} の成功時の返り値は 0 であると変更しました。返り値は 1 であると述べていましたが誤りです。
*[[第 14 章 「HotSync マネージャ API」|C/C++ Sync Suite Reference601/14]]
**{{goto HsResetComm,HsResetComm()|C/C++ Sync Suite Reference601/14}} の説明を修正しました。この関数は HotSync がリスタートされたときにローカル シリアルを除くすべての転送を使用不可にすると述べていましたが誤りです。
*[[第 17 章 「同期マネージャ API」|C/C++ Sync Suite Reference601/17]]
**{{goto PwdVerify,PwdVerify()|C/C++ Sync Suite Reference601/17}} の説明を明記しました。ハンドヘルド上のパスワードの文字はすべて小文字として保存されると述べていましたが誤りです。実際は、Palm OS バージョンが 4.0 よりも前であれば当てはまります。Palm OS バージョン 4.0 以降では、パスワードは大文字/小文字を区別されます。
!!{{anchor Additional Resources}}追加リソース {{goto top,^TOP^}}
*ドキュメント
**PalmSource 社（訳者注: 現 ACCESS 社）は以下で、本書と Palm OS 開発者のための他のドキュメントの最新バージョンを発行しています。{{br}}http://www.palmos.com/dev/support/docs/
*トレーニング
**PalmSource とそのパートナーは Palm OS 開発者のためのトレーニング クラスを主催します。トピックスとスケジュールは以下をチェックしてください。{{br}}http://www.palmos.com/dev/training
*ナレッジ ベース
**ナレッジ ベースは高速な Web-ベースの技術情報データベースです。FAQ、サンプル コード、白書、開発文書は以下を探してください。{{br}}http://www.palmos.com/dev/support/kb/
*CDK フィードバック
**CDK のフィードバック - あなたが望む機能、バグ レポート、ドキュメントの誤り、ナレッジ ベースの記事のリクエスト - を行うために以下の email アドレスを使用してください。{{br}}[cdk-feedback@palmsource.com|mailto:cdk-feedback@palmsource.com]
!!{{anchor Convention Used in this Document}}本書の慣習 {{goto top,^TOP^}}
このガイドは以下の記述慣習を使用します。
,このスタイルは...,以下のために使用されます。
,"{{span style='color:blue;font-family:monospace;',sample}}",ファイル名、コマンド、関数などのコードの要素、構造体、などのリテラル テキスト。
,''sample'',強調または変数を示すため。
,'''sample''',用語の定義または最初の使用、メニューとメニュー アイテムの名前、ユーザ供給テキスト、UI 説明の中のウィンドウ名。
,"{{goto sample,sample}}",ハイパーテキスト リンク。
,→,関数に渡されるパラメータ。
,←,関数から返されるパラメータ。
,←→,関数に渡されるて返されるパラメータ。
{{div_end}}
{{div_begin "style='border-top-style:solid;border-top-width:1px;border-top-color:silver;'"}}
[[← 目次に戻る|C/C++ Sync Suite Reference601/TOC]] [[↑トップへ|C/C++ Sync Suite Reference601]] [[パート I に進む →|C/C++ Sync Suite Reference601/I]]
{{div_end}}
