- 追加された行はこのように表示されます。
- 削除された行は
このように表示されます。
{{div_begin}}
[[← 18 章に戻る|C/C++ Sync Suite Reference601/18]] [[↑トップへ|C/C++ Sync Suite Reference601]] [[付録 B に進む →|C/C++ Sync Suite Reference601/B]]
{{div_end}}
{{div_begin style="margin-bottom:-10px"}}
!!!A 改訂履歴
{{div_end}}
{{div_begin "style='position:absolute;right:0px;font-size:70%;margin-right:15px;margin-top:15px;width:250px;'"}}
*{{goto Changes in C/C++ Sync Suite 6.0.1,C/C++ Sync Suite 6.0.1 の変更点}}
**{{goto "Sync Manager API, Version 2.5 Changes",同期マネージャ API バージョン 2.5 の変更点}}
**{{goto "VFS Manager API, Version 1.1 Changes",VFS マネージャ バージョン 1.1 の変更点}}
**{{goto File Link API Removal from HotSync Manager 6.0.1,HotSync マネージャ 6.0.1 から削除されたファイル リンク API}}
**{{goto HotSync Log API Changes for HotSync Manager 6.0.1,HotSync マネージャ 6.0.1 の HotSync ログ API の変更点}}
**{{goto "User Data API, Version 4.2 Changes",ユーザ データ API バージョン 4.2 の変更点}}
**{{goto Palm OS Common Language API Changes in HotSync Manager 6.0.1,HotSync マネージャ 6.0.1 の Palm OS 一般言語 API の変更点}}
**{{goto Conduit API Changes in HotSync Manager 6.0.1,HotSync マネージャ 6.0.1 のコンジット API の変更点}}
**{{goto HotSync Manager API Changes in HotSync Manager 6.0.1,HotSync マネージャ 6.0.1 の HotSync マネージャ API の変更点}}
*{{goto Changes in C/C++ Sync Suite 6.0a,C/C++ Sync Suite 6.0a の変更点}}
*{{goto Changes in C/C++ Sync Suite 6.0,C/C++ Sync Suite 6.0 の変更点}}
**{{goto "Sync Manager API, Version 2.4 Changes",同期マネージャ API バージョン 2.4 の変更点}}
**{{goto Conduit Entry Point API Changes,コンジット エントリ ポイント API の変更点}}
**{{goto "Conduit Manager API, Version 3 Changes",コンジット マネージャ API バージョン 3 の変更点}}
**{{goto "Install Conduit Manager API, Version 3 Changes",インストール コンジット マネージャ API バージョン 3 の変更点}}
**{{goto "Notifier Install Manager API, Version 3 Changes",通知機能インストール マネージャ バージョン 3 の変更点}}
**{{goto HotSync Log API Changes,HotSync ログ API の変更点}}
**{{goto "HotSync Manager API, Version 2 Changes",HotSync マネージャ API バージョン 2 の変更点}}
**{{goto "VFS Manager API, Version 1.0 Changes",VFS マネージャ API バージョン 1.0 の変更点}}
**{{goto "User Data API, Version 4.1 Changes in 6.0",ユーザ データ API バージョン 4.1 の変更点}}
**{{goto "Install Aide API, Version 4.1 Changes",インストール援助機能 API バージョン 4.1 の変更点}}
**{{goto File Linking API Changes,ファイル リンク API の変更点}}
**{{goto Palm OS Common Language API Changes,Palm OS 一般言語 API の変更点}}
*{{goto Changes in C/C++ Sync Suite 4.03,C/C++ Sync Suite 4.03 の変更点}}
**{{goto Sync Manager API Changes,同期マネージャ API の変更点}}
**{{goto HotSync Manager API Changes in 4.03,HotSync マネージャ API の変更点}}
**{{goto "User Data API, Version 4.1 Changes in 4.03",ユーザ データ API バージョン 4.1 の変更点}}
*{{goto Changes in C/C++ Sync Suite 4.02/4.02a,C/C++ Sync Suite 4.02/4.02a の変更点}}
**{{goto "Expansion Manager and VFS Manager API, Version 1.0 Changes",拡張マネージャと VFS マネージャ バージョン 1.0 の変更点}}
**{{goto "Sync Manager API, Version 2.3 Changes",同期マネージャ API バージョン 2.3 の変更点}}
**{{goto "User Data API, Version 4.0 Changes",ユーザ データ API バージョン 4.0 の変更点}}
**{{goto "Install Aide API, Version 4.0 Changes",インストール援助機能バージョン 4.0 の変更点}}
**{{goto "Conduit Manager, Version 2 Changes",コンジット マネージャ バージョン 2 の変更点}}
**{{goto Password Library Changes,パスワード ライブラリの変更点}}
**{{goto HotSync Manager API Changes in 4.02,HotSync マネージャ API の変更点}}
{{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 のバージョン 4.02 から後の各 CDK バージョンで追加された C/C++ Sync Suite 関数と他の Feature をリスト アップします。あなたは新しい関数や Feature を使用する前に、それらがエンド ユーザのデスクトップ コンピュータにインストールされている DLL に実装されていることを保証するためにチェックしなければなりません。たいていの API は API のバージョン番号を取得するための関数を含んでいます。あなたのアプリケーションがすべてのバージョンでは利用可能でない関数を呼び出す前に、それらの関数を使って API のバージョン番号をチェックすべきです。「バージョンを取得する」ための関数を持たない API に対しては、あなたは HotSync マネージャの実行形式ファイルのバージョンをチェックすることができます。
この付録の各節では CDK の以下のバージョンの変更点について説明します:
*{{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 の変更点}}
*{{goto Changes in C/C++ Sync Suite 6.0,C/C++ Sync Suite 6.0 の変更点}}
*{{goto Changes in C/C++ Sync Suite 4.03,C/C++ Sync Suite 4.03 の変更点}}
*{{goto Changes in C/C++ Sync Suite 4.02/4.02a,C/C++ Sync Suite 4.02/4.02a の変更点}}
CDK のここ最近のリリースで利用可能になった機能強化と新しい Feature の要約については、''Introduction to Conduit Development'' の [[第 1 章 「Palm OS CDK の新機能」|Introduction to Conduit Development601/1]] を参照してください。
!!{{anchor Changes in C/C++ Sync Suite 6.0.1}}C/C++ Sync Suite 6.0.1 の変更点 {{goto top,^TOP^}}
この節では CDK のバージョン 6.0.1 で変更された C/C++ Sync Suite の API と他の Feature をリスト アップします。
*{{goto "Sync Manager API, Version 2.5 Changes",同期マネージャ API バージョン 2.5 の変更点}}
*{{goto "VFS Manager API, Version 1.1 Changes",VFS マネージャ バージョン 1.1 の変更点}}
*{{goto File Link API Removal from HotSync Manager 6.0.1,HotSync マネージャ 6.0.1 から削除されたファイル リンク API}}
*{{goto HotSync Log API Changes for HotSync Manager 6.0.1,HotSync マネージャ 6.0.1 の HotSync ログ API の変更点}}
*{{goto "User Data API, Version 4.2 Changes",ユーザ データ API バージョン 4.2 の変更点}}
*{{goto Palm OS Common Language API Changes in HotSync Manager 6.0.1,HotSync マネージャ 6.0.1 の Palm OS 一般言語 API の変更点}}
*{{goto Conduit API Changes in HotSync Manager 6.0.1,HotSync マネージャ 6.0.1 のコンジット API の変更点}}
*{{goto HotSync Manager API Changes in HotSync Manager 6.0.1,HotSync マネージャ 6.0.1 の HotSync マネージャ API の変更点}}
!{{anchor "Sync Manager API, Version 2.5 Changes"}}同期マネージャ API バージョン 2.5 の変更点 {{goto top,^TOP^}}
同期マネージャ API のバージョン 2.5 では以下の変更がなされました:
*{{goto SyncBackupDatabase,SyncBackupDatabase()|C/C++ Sync Suite Reference601/5-2}} が追加されました。
*{{goto SyncCallDeviceApplication,SyncCallDeviceApplication()|C/C++ Sync Suite Reference601/5-2}} と {{goto CCallApplicationParams,CCallApplicationParams|C/C++ Sync Suite Reference601/5-2}} が追加されました。
*{{goto SyncCallRemoteModule,SyncCallRemoteModule()|C/C++ Sync Suite Reference601/4-1}} と {{goto CCallModuleParams,CCallModuleParams|C/C++ Sync Suite Reference601/4-1}} は {{span style='color:blue;font-family:monospace;',SyncCommon.h}} から {{span style='color:blue;font-family:monospace;',SyncMgr.h}} に移動させられました。この関数は Palm OS Garnet かそれ以前のハンドヘルドに対してのみ機能します。
*{{span style='color:blue;font-family:monospace;',SyncDmReadAppPreference()}} と {{span style='color:blue;font-family:monospace;',SyncDmWriteAppPreference()}} が削除されました。これらの関数は 64 KBにサイズを制限されない {{goto application preferences,アプリケーション設定|Introduction to Conduit Development601/A}} を読み込み/書き込みするために設計されたものです。Palm OS Cobalt の バージョン 6.0.1 は 64 KB よりも小さな設定だけをサポートします。なぜなら、設定は {{goto classic database,クラシック データベース|Introduction to Conduit Development601/A}} に保存されるからです。そのため、あなたはそれらの関数の代わりにクラシック同期マネージャ関数 {{goto SyncReadAppPreference,SyncReadAppPreference()|C/C++ Sync Suite Reference601/4-2}} と {{goto SyncWriteAppPreference,SyncWriteAppPreference()|C/C++ Sync Suite Reference601/4-2}} を使用しなければなりません。あなたのアプリケーションが 64 KB よりも大きな設定を保存する必要がある場合、あなたは他の手段を使わなければなりません - 例えば、設定をシステムのアプリケーション設定データベースではなくあなたのアプリケーション自体のデータベースに保存します。
*{{goto SyncReadPositionXMap,SyncReadPositionXMap()|C/C++ Sync Suite Reference601/4-2}} の {{goto Sync Manager Version 2.5,「同期マネージャ バージョン 2.5」|C/C++ Sync Suite Reference601/4-2}} で説明されている問題が修正されました。
*{{span_begin style='font-family:monospace;'}}#define {{span style='color:blue;',SYNCAPI_VER_MINOR_5}}{{span_end}} が追加されました。
!{{anchor "VFS Manager API, Version 1.1 Changes"}}VFS マネージャ バージョン 1.1 の変更点 {{goto top,^TOP^}}
VFS マネージャのバージョン 1.1 では以下の変更がなされました:
*コンジットが Palm OS バージョン 6.0.1 以降を実行しているハンドヘルド上の拡張カードとデータベース イメージを Export/Import できるようにするために {{goto VFSImportDatabaseFromFileEx,VFSImportDatabaseFromFileEx()|C/C++ Sync Suite Reference601/10}} と {{goto VFSExportDatabaseToFileEx,VFSExportDatabaseToFileEx()|C/C++ Sync Suite Reference601/10}} が追加されました。これらの関数は Palm OS Cobalt ハンドヘルドと Export/Import するための既存の関数 ({{goto VFSExportDatabaseToFile,VFSExportDatabaseToFile()|C/C++ Sync Suite Reference601/10}} と {{goto VFSImportDatabaseFromFile,VFSImportDatabaseFromFile()|C/C++ Sync Suite Reference601/10}}) を使用を推奨されない関数にしました。
*{{span_begin style='font-family:monospace;'}}#define {{span style='color:blue;',VFSAPI_VER_MINOR_1}}{{span_end}} が追加されました。
!{{anchor File Link API Removal from HotSync Manager 6.0.1}}HotSync マネージャ 6.0.1 から削除されたファイル リンク API {{goto top,^TOP^}}
ファイル リンク Feature は HotSync マネージャ 6.0.1 から削除されたため、ファイル リンク API を宣言していた {{span style='color:blue;font-family:monospace;',Subscribe.h}} は CDK 6.0.1 から削除されました。
!{{anchor HotSync Log API Changes for HotSync Manager 6.0.1}}HotSync マネージャ 6.0.1 の HotSync ログ API の変更点 {{goto top,^TOP^}}
以下の値は {{goto Activity,Activity|C/C++ Sync Suite Reference601/7}} 列挙体に追加されました:
*{{span style='color:blue;font-family:monospace;',slSyncSessionStart}}
*{{span style='color:blue;font-family:monospace;',slSyncSessionEnd}}
*{{span style='color:blue;font-family:monospace;',slSyncSessionCancelled}}
*{{span style='color:blue;font-family:monospace;',slError}}
*{{span style='color:blue;font-family:monospace;',slRecommendation}}
*{{span style='color:blue;font-family:monospace;',slHTMLText}}
HotSync マネージャのバージョン 6.0.1 から、HotSync ログは ASCII テキスト ファイルではなく HTML ファイルとして保存されるようになりました。{{goto Adding Messages to the HotSync Log,「HotSync ログへのメッセージの追加」|Introduction to Conduit Development601/4}} を参照してください。
ファイル リンク Feature は HotSync マネージャ 6.0.1 から削除されたため、以下の {{span style='color:blue;font-family:monospace;',Activity}} 列挙値は使用を推奨されなくなりました:
{{span style='color:blue;font-family:monospace;',slDoubleModifySubsc, slFileLinkCompleted, slFileLinkDeleted}}
!{{anchor "User Data API, Version 4.2 Changes"}}ユーザ データ API バージョン 4.2 の変更点 {{goto top,^TOP^}}
ユーザ データ API のバージョン 4.2 では以下の変更がなされました:
*アプリケーションがユーザのハンドヘルドの Palm OS バージョンを読み込めるようにするために、{{goto Palm OS Version Section and Key Names,「Palm OS バージョンのセクションとキー名」|C/C++ Sync Suite Reference601/16}} に {{span style='font-family:monospace;',#define}} が追加されました。HotSync マネージャはバージョンを各 HotSync の最中にユーザ データ保存場所に書き込みます。
*{{goto UmIsUserNameValid,UmIsUserNameValid()|C/C++ Sync Suite Reference601/16}} が追加されました。
*将来使用するためにエラー コード {{span style='color:blue;font-family:monospace;',ERR_UM_NO_DEFAULT_USER}} と {{span style='color:blue;font-family:monospace;',ERR_UM_MULTIPLE_USERS_EXISTS}} が追加されました。
!{{anchor Palm OS Common Language API Changes in HotSync Manager 6.0.1}}HotSync マネージャ 6.0.1 の Palm OS 一般言語 API の変更点 {{goto top,^TOP^}}
HotSync マネージャ バージョン 6.0.1 では、{{span style='color:blue;font-family:monospace;',LANG_DLL.h}} の中の {{span_begin style='font-family:monospace;'}}#define {{span style='color:blue;',LANGUAGE_TCHINESE}}{{span_end}} の値が 0x0404 から 0x4000 に変更されました。
!{{anchor Conduit API Changes in HotSync Manager 6.0.1}}HotSync マネージャ 6.0.1 のコンジット API の変更点 {{goto top,^TOP^}}
ファイル リンク Feature は HotSync マネージャ 6.0.1 から削除されたため、以下のエントリ ポイントが {{span style='color:blue;font-family:monospace;',CondAPI.h}} から削除されました:
*{{span style='color:blue;font-family:monospace;',ImportData()}}
*{{span style='color:blue;font-family:monospace;',ConfigureSubscription()}}
*{{span style='color:blue;font-family:monospace;',SubscriptionSupported()}}
*{{span style='color:blue;font-family:monospace;',UpdateTables()}}
{{span style='color:blue;font-family:monospace;',CONDERR_SUBSCRIBE_FAILED}} エラー コードは使用を推奨されなくなりました。
!{{anchor HotSync Manager API Changes in HotSync Manager 6.0.1}}HotSync マネージャ 6.0.1 の HotSync マネージャ API の変更点 {{goto top,^TOP^}}
ファイル リンク Feature は HotSync マネージャ 6.0.1 から削除されたため、{{goto HsDisplayFileLink,HsDisplayFileLink()|C/C++ Sync Suite Reference601/14}} は使用を推奨されなくなりました。
!!{{anchor Changes in C/C++ Sync Suite 6.0a}}C/C++ Sync Suite 6.0a の変更点 {{goto top,^TOP^}}
同期マネージャ API のバージョン 2.4 では以下の変更がなされました:
*{{goto SyncCallRemoteModule,SyncCallRemoteModule()|C/C++ Sync Suite Reference601/4-1}} と {{goto CCallModuleParams,CCallModuleParams|C/C++ Sync Suite Reference601/4-1}} は {{span style='color:blue;font-family:monospace;',SyncCommon.h}} から {{span style='color:blue;font-family:monospace;',SyncMgr.h}} に移動させられました。なぜなら、この関数はクラシック リソース データベースであるアプリケーションと拡張 リソース データベースであるアプリケーションを区別することができないからです。そのため、Palm OS Garnet かそれ以前のハンドヘルドと同期するときにのみこの関数を呼び出してください。Palm OS Cobalt ハンドヘルドでは、この関数の代わりに {{goto SyncCallDeviceApplication,SyncCallDeviceApplication()|C/C++ Sync Suite Reference601/5-2}} を呼び出してください。
!!{{anchor Changes in C/C++ Sync Suite 6.0}}C/C++ Sync Suite 6.0 の変更点 {{goto top,^TOP^}}
この節では CDK のバージョン 6.0 で変更された C/C++ Sync Suite の API と他の Feature をリスト アップします。
*{{goto "Sync Manager API, Version 2.4 Changes",同期マネージャ API バージョン 2.4 の変更点}}
*{{goto Conduit Entry Point API Changes,コンジット エントリ ポイント API の変更点}}
*{{goto "Conduit Manager API, Version 3 Changes",コンジット マネージャ API バージョン 3 の変更点}}
*{{goto "Install Conduit Manager API, Version 3 Changes",インストール コンジット マネージャ API バージョン 3 の変更点}}
*{{goto "Notifier Install Manager API, Version 3 Changes",通知機能インストール マネージャ バージョン 3 の変更点}}
*{{goto HotSync Log API Changes,HotSync ログ API の変更点}}
*{{goto "HotSync Manager API, Version 2 Changes",HotSync マネージャ API バージョン 2 の変更点}}
*{{goto "VFS Manager API, Version 1.0 Changes",VFS マネージャ API バージョン 1.0 の変更点}}
*{{goto "User Data API, Version 4.1 Changes in 6.0",ユーザ データ API バージョン 4.1 の変更点}}
*{{goto "Install Aide API, Version 4.1 Changes",インストール援助機能 API バージョン 4.1 の変更点}}
*{{goto File Linking API Changes,ファイル リンク API の変更点}}
*{{goto Palm OS Common Language API Changes,Palm OS 一般言語 API の変更点}}
!{{anchor "Sync Manager API, Version 2.4 Changes"}}同期マネージャ API バージョン 2.4 の変更点 {{goto top,^TOP^}}
同期マネージャ API のバージョン 2.4 では以下の変更がなされました:
*[[スキーマ同期マネージャ|C/C++ Sync Suite Reference601/2]]: {{span style='color:blue;font-family:monospace;',SyncDb...()}} が追加されました。
*[[拡張同期マネージャ|C/C++ Sync Suite Reference601/3]]: {{span style='color:blue;font-family:monospace;',SyncDm...()}} が追加されました。
*{{span style='color:blue;font-family:monospace;',Sync*.h}} ヘッダ ファイルは [[パート I 「同期マネージャ API」|C/C++ Sync Suite Reference601/I]] で説明されているように再編成されました。
*[[第 5 章 「共通同期マネージャ API」|C/C++ Sync Suite Reference601/5]] で説明されているように、以下のユーティリティ関数が {{span style='color:blue;font-family:monospace;',SyncCommon.h}} に追加されました:
**{{goto SyncBackupSecurityData,SyncBackupSecurityData()|C/C++ Sync Suite Reference601/5-2}}
**{{goto SyncGenerateBackupFileName,SyncGenerateBackupFileName()|C/C++ Sync Suite Reference601/5-2}}
**{{goto SyncGetDesktopTrustStatus,SyncGetDesktopTrustStatus()|C/C++ Sync Suite Reference601/5-2}}
**{{goto SyncInstallAndBackupDatabase,SyncInstallAndBackupDatabase()|C/C++ Sync Suite Reference601/5-2}}
**{{goto SyncInstallDatabase,SyncInstallDatabase()|C/C++ Sync Suite Reference601/5-2}}
**{{goto SyncIsDatabaseBackupNeeded,SyncIsDatabaseBackupNeeded()|C/C++ Sync Suite Reference601/5-2}}
**{{goto SyncRestoreSecurityData,SyncRestoreSecurityData()|C/C++ Sync Suite Reference601/5-2}}
**{{goto SyncIsDatabaseBackupNeeded,SyncIsDatabaseBackupNeeded()|C/C++ Sync Suite Reference601/5-2}}
*{{goto SyncReadPositionXMap,SyncReadPositionXMap()|C/C++ Sync Suite Reference601/4-2}} の {{goto Sync Manager Version 2.4,「同期マネージャ バージョン 2.4」|C/C++ Sync Suite Reference601/4-2}} で説明されている問題が修正されました。
*{{goto SyncMaxRemoteRecSize,SyncMaxRemoteRecSize()|C/C++ Sync Suite Reference601/4-1}} はクラシック データベースの最大レコード サイズとしてハンドヘルド上の Palm OS のバージョンに関係なく 65,505 を返します。
!{{anchor Conduit Entry Point API Changes}}コンジット エントリ ポイント API の変更点 {{goto top,^TOP^}}
コンジットが HotSync マネージャ 6.0 以降に対して機能するために実装するコンジット エントリ ポイント API のこのバージョンでは以下の変更がなされました:
*{{goto RegistrationInfoType,RegistrationInfoType|C/C++ Sync Suite Reference601/6}} 構造体が追加されました。
*以下の {{goto ConduitInfoEnum,ConduitInfoEnum|C/C++ Sync Suite Reference601/6}} 値が追加されました:
**{{span style='color:blue;font-family:monospace;',eRegistrationInfo}}
**{{span style='color:blue;font-family:monospace;',eDoNotDisplayInCustomDialog}}
**{{span style='color:blue;font-family:monospace;',eRunAlways}}
**{{span style='color:blue;font-family:monospace;',eDoNotDisplayProgress}}
*HotSync マネージャは変更され、それによりコンジットの MFC バージョンをチェックする必要がなくなりました。そのため、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;',eMfcVersion}} 値を渡してくることはなくなりました。
*これらの API 要素は [[第 6 章 「コンジット エントリ ポイント API」|C/C++ Sync Suite Reference601/6]] で定義されています。
!{{anchor "Conduit Manager API, Version 3 Changes"}}コンジット マネージャ API バージョン 3 の変更点 {{goto top,^TOP^}}
コンジット マネージャ API のバージョン 3 では以下の変更がなされました:
*同じシステム上の異なる Windows ユーザに対して異なるコンジットを登録する能力が追加されました。
*DLL を特別なフォルダ - HotSync マネージャはこのフォルダを見つけ出し、そこにあるコンジットを通常通りに登録されたコンジットと同様に呼び出します - にコピーすることによって C API ベース コンジットを登録する能力が追加されました。
*いくつかのコンジット コンフィグレーション エントリの使用が推奨されなくなりました。HotSync マネージャはそれらを取得/セットする API を使用しなくなりました。
*必須であり最も一般的に使用されるコンジット コンフィグレーション エントリだけを指定/受け取るために、新しいサイズを修正された {{goto CmConduitType2,CmConduitType2|C/C++ Sync Suite Reference601/11-1}} が追加されました。
*使用されなくなったいくつかの {{span style='font-family:monospace;',#define}} 定数が削除されました: {{span style='color:blue;font-family:monospace;',"BACKUP_CONDUIT, MAX_SPECIAL, INVALID_CREATORID, INVALID_INTEGRATE, INVALID_PRIORITY"}}
*{{goto CmGetConduitCreatorID,CmGetConduitCreatorID()|C/C++ Sync Suite Reference601/11-1}} は返り時に {{span style='color:blue;font-family:monospace;',piSize}} パラメータを正しく実際のあるいは必要とされるクリエイタ ID 文字列のサイズに変更するようになりました。これより前のコンジット マネージャのバージョンでは、正しくありませんでした。
*以下のコンジット マネージャ関数が追加されました:
**{{goto CmGetDiscoveryInfoByIndex,CmGetDiscoveryInfoByIndex()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmGetSystemBackupConduit,CmGetSystemBackupConduit()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmGetSystemConduitByCreator,CmGetSystemConduitByCreator()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmGetSystemConduitByIndex,CmGetSystemConduitByIndex()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmGetSystemConduitCount,CmGetSystemConduitCount()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmGetSystemConduitCreatorID,CmGetSystemConduitCreatorID()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmGetSystemCreatorDirectory,CmGetSystemCreatorDirectory()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmGetSystemCreatorFile,CmGetSystemCreatorFile()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmGetSystemCreatorIDList,CmGetSystemCreatorIDList()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmGetSystemCreatorName,CmGetSystemCreatorName()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmGetSystemCreatorPriority,CmGetSystemCreatorPriority()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmGetSystemCreatorRemote,CmGetSystemCreatorRemote()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmGetSystemCreatorTitle,CmGetSystemCreatorTitle()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmGetSystemCreatorValueDword,CmGetSystemCreatorValueDword()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmGetSystemCreatorValueString,CmGetSystemCreatorValueString()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmGetSystemDiscoveryInfoByIndex,CmGetSystemDiscoveryInfoByIndex()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmGetSystemHotSyncExecPath,CmGetSystemHotSyncExecPath()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmInstallSystemConduitByStruct,CmInstallSystemConduitByStruct()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmInstallSystemCreator,CmInstallSystemCreator()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmIsCurrentUserAdmin,CmIsCurrentUserAdmin()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmRemoveSystemConduitByCreatorID,CmRemoveSystemConduitByCreatorID()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmRemoveSystemConduitByIndex,CmRemoveSystemConduitByIndex()|C/C++ Sync Suite Reference601/11-2}}
**{{goto CmSetSystemBackupConduit,CmSetSystemBackupConduit()|C/C++ Sync Suite Reference601/11-3}}
**{{goto CmSetSystemCreatorDirectory,CmSetSystemCreatorDirectory()|C/C++ Sync Suite Reference601/11-3}}
**{{goto CmSetSystemCreatorFile,CmSetSystemCreatorFile()|C/C++ Sync Suite Reference601/11-3}}
**{{goto CmSetSystemCreatorName,CmSetSystemCreatorName()|C/C++ Sync Suite Reference601/11-3}}
**{{goto CmSetSystemCreatorPriority,CmSetSystemCreatorPriority()|C/C++ Sync Suite Reference601/11-3}}
**{{goto CmSetSystemCreatorRemote,CmSetSystemCreatorRemote()|C/C++ Sync Suite Reference601/11-3}}
**{{goto CmSetSystemCreatorTitle,CmSetSystemCreatorTitle()|C/C++ Sync Suite Reference601/11-3}}
**{{goto CmSetSystemCreatorValueDword,CmSetSystemCreatorValueDword()|C/C++ Sync Suite Reference601/11-3}}
**{{goto CmSetSystemCreatorValueString,CmSetSystemCreatorValueString()|C/C++ Sync Suite Reference601/11-3}}
**{{goto FmDisableCurrentUserConduitByIndex,FmDisableCurrentUserConduitByIndex()|C/C++ Sync Suite Reference601/11-3}}
**{{goto FmDisableCurrentUserConduitByPath,FmDisableCurrentUserConduitByPath()|C/C++ Sync Suite Reference601/11-3}}
**{{goto FmDisableSystemConduitByIndex,FmDisableSystemConduitByIndex()|C/C++ Sync Suite Reference601/11-3}}
**{{goto FmDisableSystemConduitByPath,FmDisableSystemConduitByPath()|C/C++ Sync Suite Reference601/11-3}}
**{{goto FmEnableCurrentUserConduitByPath,FmEnableCurrentUserConduitByPath()|C/C++ Sync Suite Reference601/11-3}}
**{{goto FmEnableSystemConduitByPath,FmEnableSystemConduitByPath()|C/C++ Sync Suite Reference601/11-3}}
**{{goto FmGetCurrentUserConduitFolder,FmGetCurrentUserConduitFolder()|C/C++ Sync Suite Reference601/11-3}}
**{{goto FmGetCurrentUserDisabledConduitFolder,FmGetCurrentUserDisabledConduitFolder()|C/C++ Sync Suite Reference601/11-3}}
**{{goto FmGetSystemConduitByIndex,FmGetSystemConduitByIndex()|C/C++ Sync Suite Reference601/11-3}}
**{{goto FmGetSystemConduitCount,FmGetSystemConduitCount()|C/C++ Sync Suite Reference601/11-3}}
**{{goto FmGetSystemConduitFolder,FmGetSystemConduitFolder()|C/C++ Sync Suite Reference601/11-3}}
**{{goto FmGetSystemDisabledConduitFolder,FmGetSystemDisabledConduitFolder()|C/C++ Sync Suite Reference601/11-3}}
!{{anchor "Install Conduit Manager API, Version 3 Changes"}}インストール コンジット マネージャ API バージョン 3 の変更点 {{goto top,^TOP^}}
インストール コンジット マネージャのバージョン 3 では以下の変更がなされました:
*同じシステム上の異なる Windows ユーザに対して異なるインストール コンジットを登録する能力が追加されました。
*インストーラがシステムのためにインストール コンジットを登録できるようにするために以下の関数が追加されました:
**{{goto ImGetSystemDirectory,ImGetSystemDirectory()|C/C++ Sync Suite Reference601/12}}
**{{goto ImGetSystemDWord,ImGetSystemDWord()|C/C++ Sync Suite Reference601/12}}
**{{goto ImGetSystemExtension,ImGetSystemExtension()|C/C++ Sync Suite Reference601/12}}
**{{goto ImGetSystemMask,ImGetSystemMask()|C/C++ Sync Suite Reference601/12}}
**{{goto ImGetSystemModule,ImGetSystemModule()|C/C++ Sync Suite Reference601/12}}
**{{goto ImGetSystemName,ImGetSystemName()|C/C++ Sync Suite Reference601/12}}
**{{goto ImGetSystemString,ImGetSystemString()|C/C++ Sync Suite Reference601/12}}
**{{goto ImRegisterSystem,ImRegisterSystem()|C/C++ Sync Suite Reference601/12}}
**{{goto ImSetSystemDirectory,ImSetSystemDirectory()|C/C++ Sync Suite Reference601/12}}
**{{goto ImSetSystemDWord,ImSetSystemDWord()|C/C++ Sync Suite Reference601/12}}
**{{goto ImSetSystemExtension,ImSetSystemExtension()|C/C++ Sync Suite Reference601/12}}
**{{goto ImSetSystemMask,ImSetSystemMask()|C/C++ Sync Suite Reference601/12}}
**{{goto ImSetSystemModule,ImSetSystemModule()|C/C++ Sync Suite Reference601/12}}
**{{goto ImSetSystemName,ImSetSystemName()|C/C++ Sync Suite Reference601/12}}
**{{goto ImSetSystemString,ImSetSystemString()|C/C++ Sync Suite Reference601/12}}
**{{goto ImUnregisterSystemID,ImUnregisterSystemID()|C/C++ Sync Suite Reference601/12}}
!{{anchor "Notifier Install Manager API, Version 3 Changes"}}通知機能インストール マネージャ バージョン 3 の変更点 {{goto top,^TOP^}}
通知機能インストール マネージャ API のバージョン 3 では以下の変更がなされました:
*同じシステム上の異なる Windows ユーザに対して異なる通知機能を登録する能力が追加されました。
*インストーラがシステムのために通知機能を登録できるようにするために以下の関数が追加されました:
**{{goto NmFindSystem,NmFindSystem()|C/C++ Sync Suite Reference601/13}}
**{{goto NmGetSystemByIndex,NmGetSystemByIndex()|C/C++ Sync Suite Reference601/13}}
**{{goto NmGetSystemCount,NmGetSystemCount()|C/C++ Sync Suite Reference601/13}}
**{{goto NmRegisterSystem,NmRegisterSystem()|C/C++ Sync Suite Reference601/13}}
**{{goto NmRenameSystemByIndex,NmRenameSystemByIndex()|C/C++ Sync Suite Reference601/13}}
**{{goto NmUnregisterSystem,NmUnregisterSystem()|C/C++ Sync Suite Reference601/13}}
!{{anchor HotSync Log API Changes}}HotSync ログ API の変更点 {{goto top,^TOP^}}
同期マネージャ バージョン 2.4 以降とともに出荷される HotSync ログ API のバージョンには以下の変更がなされました:
*{{goto Activity,Activity|C/C++ Sync Suite Reference601/7}} 列挙体に {{span style='color:blue;font-family:monospace;',slSyncDidNothing}} 値が追加されました。
*以下の HotSync ログ API 関数はプライベート関数に変更され、もはや {{goto HotSync Log Functions,「HotSync ログ関数」|C/C++ Sync Suite Reference601/7}} ではドキュメント化されなくなりました:
**{{span style='color:blue;font-family:monospace;',LogBuildRemoteLog()}}
**{{span style='color:blue;font-family:monospace;',LogCloseLog()}}
**{{span style='color:blue;font-family:monospace;',LogGetWorkFileName()}}
**{{span style='color:blue;font-family:monospace;',LogInit()}}
**{{span style='color:blue;font-family:monospace;',LogSaveLog()}}
**{{span style='color:blue;font-family:monospace;',LogUnInit()}}
***コンジットが使用することをサポートされるのは {{goto LogAddEntry,LogAddEntry()|C/C++ Sync Suite Reference601/7}}, {{goto LogAddFormattedEntry,LogAddFormattedEntry()|C/C++ Sync Suite Reference601/7}}, {{goto LogTestCounters,LogTestCounters()|C/C++ Sync Suite Reference601/7}} だけです。
!{{anchor "HotSync Manager API, Version 2 Changes"}}HotSync マネージャ API バージョン 2 の変更点 {{goto top,^TOP^}}
HotSync マネージャ API のバージョン 2 では以下の変更がなされました:
*{{span style='color:blue;font-family:monospace;',HSFLAG_INSPECT_CONDUIT}} 定数が追加され、それにより {{goto HsSetAppStatus,HsSetAppStatus()|C/C++ Sync Suite Reference601/14}} は HotSync マネージャを開始するときに Conduit Inspector を開始できるようになりました。そうするためには、呼び出し元はこの定数を {{span style='color:blue;font-family:monospace;',dwStartFlags}} パラメータに渡さなければなりません。{{goto Start Options,「開始オプション」|C/C++ Sync Suite Reference601/14}} を参照してください。
*{{goto HsGetApiVersion,HsGetApiVersion()|C/C++ Sync Suite Reference601/14}} が返す値として {{span style='color:blue;font-family:monospace;',HS_API_VERSION_2}} 定数が追加されました。この定数は {{goto HotSync Manager API バージョン,「HotSync マネージャ バージョン」|C/C++ Sync Suite Reference601/14}} で定義されています。
!{{anchor "VFS Manager API, Version 1.0 Changes"}}VFS マネージャ API バージョン 1.0 の変更点 {{goto top,^TOP^}}
VFS マネージャ API のバージョン 1.0 では以下の変更がなされました:
*{{span style='color:blue;font-family:monospace;',VFSMgr.h}} ファイルに {{span style='color:blue;font-family:monospace;',vfsVolumeAttrHidden}} 値が追加されました。これは {{goto Volume Attributes,「ボリューム属性」|C/C++ Sync Suite Reference601/10}} で説明されています。
*{{span style='color:blue;font-family:monospace;',VFSMgr.h}} から {{span style='color:blue;font-family:monospace;',vfsMountClass_POSE}} 定数が削除されました。なぜなら、この定数をデスクトップ VFS マネージャから使用することはできないからです。
*{{goto Volume Format/Mount Flags,「ボリューム フォーマット/マウント フラグ」|C/C++ Sync Suite Reference601/10}} が追加されました。これは {{goto VFSVolumeFormat,VFSVolumeFormat()|C/C++ Sync Suite Reference601/10}} を呼び出すときに {{span style='color:blue;font-family:monospace;',byMountFlags}} パラメータに渡すことができます。
VFS マネージャ API バージョン番号は変更されていないということに注意してください: {{goto VFSGetAPIVersion,VFSGetAPIVersion()|C/C++ Sync Suite Reference601/10}} は CDK 4.03 と同様にバージョン 1.0 を返します。
!{{anchor "User Data API, Version 4.1 Changes in 6.0"}}ユーザ データ API バージョン 4.1 の変更点 {{goto top,^TOP^}}
ユーザ データ API のバージョン 4.1 では以下の変更がなされました:
*{{goto UmGetLibVersion,UmGetLibVersion()|C/C++ Sync Suite Reference601/16}} が返す値として {{span style='color:blue;font-family:monospace;',UM_LIB_VER_MAJOR}} と {{span style='color:blue;font-family:monospace;',UM_LIB_VER_MINOR}} 定数が追加されました。これらの定数は {{goto Version of the User Data API,「ユーザ データ API のバージョン」|C/C++ Sync Suite Reference601/16}} で定義されています。
ユーザ データ マネージャ API バージョン番号は変更されていないということに注意してください: {{span style='color:blue;font-family:monospace;',UmGetLibVersion()}} は CDK 4.03 と同様にバージョン 4.1 を返します。
!{{anchor "Install Aide API, Version 4.1 Changes"}}インストール援助機能 API バージョン 4.1 の変更点 {{goto top,^TOP^}}
インストール援助機能 API のバージョン 4.1 では以下の変更がなされました:
*{{span style='color:blue;font-family:monospace;',PltSetInstallRegistry()}} によってセットされたインストール コンジットのコンフィグレーション エントリを削除するために {{goto PltRemoveInstallRegistry,PltRemoveInstallRegistry()|C/C++ Sync Suite Reference601/15}} 関数が追加されました。
*{{goto PltGetLibVersion,PltGetLibVersion()|C/C++ Sync Suite Reference601/15}} が返す値として {{span style='color:blue;font-family:monospace;',INSTAIDE_LIB_VER_MAJOR}} と {{span style='color:blue;font-family:monospace;',INSTAIDE_LIB_VER_MINOR}} 定数が追加されました。これらの新しい定数は {{goto Version of the Install Aide API,「インストール援助機能 API のバージョン」|C/C++ Sync Suite Reference601/15}} で定義されています。
!{{anchor File Linking API Changes}}ファイル リンク API の変更点 {{goto top,^TOP^}}
HotSync マネージャ バージョン 6.0 では、ファイル リンクは使用を推奨されなくなりました。いずれかのデータベース タイプ (スキーマ、拡張、クラシック) に対するファイル リンクを実装するコンジットは以前どおりに機能し続けますが、カテゴリに対する制限は残っています: 15 文字までの名前を持つカテゴリが 16 個です。確かなアップグレード シナリオではファイル リンク カテゴリの中のレコードは複写されるようになります (訳者: 元のレコードとファイル リンクで二重になる)。
あなたが Visual C++ .NET で開発している場合は、あなたは {{span style='color:blue;font-family:monospace;',Subs50.lib}} にリンクをはらなくてはなりません; あなたが Visual C++ バージョン 6 を使用している場合は、{{span style='color:blue;font-family:monospace;',Subs30.lib}} にリンクをはってください。
!{{anchor Palm OS Common Language API Changes}}Palm OS 一般言語 API の変更点 {{goto top,^TOP^}}
HotSync マネージャ バージョン 6.0 では、{{span_begin style='font-family:monospace;'}}#define {{span style='color:blue;',LANGUAGE_SCHINESE}}{{span_end}} が {{span style='color:blue;font-family:monospace;',LAND_DLL.h}} に追加されました。
!!{{anchor Changes in C/C++ Sync Suite 4.03}}C/C++ Sync Suite 4.03 の変更点 {{goto top,^TOP^}}
この節では CDK のバージョン 4.03 で変更された C/C++ Sync Suite の API と他の Feature をリスト アップします。
*{{goto Sync Manager API Changes,同期マネージャ API の変更点}}
*{{goto HotSync Manager API Changes in 4.03,HotSync マネージャ API の変更点}}
*{{goto "User Data API, Version 4.1 Changes in 4.03",ユーザ データ API バージョン 4.1 の変更点}}
!{{anchor Sync Manager API Changes}}同期マネージャ API の変更点 {{goto top,^TOP^}}
{{goto eDbFlags,"\"eDbFlags\"|C/C++ Sync Suite Reference601/5-1"}} で説明されているように {{span style='color:blue;font-family:monospace;',eDbFlags}} 列挙体に値が追加されました。新しい値は以下のものです:
*{{span style='color:blue;font-family:monospace;',eStream}}
*{{span style='color:blue;font-family:monospace;',eHidden}}
*{{span style='color:blue;font-family:monospace;',eLaunchableData}}
*{{span style='color:blue;font-family:monospace;',eRecyclable}}
*{{span style='color:blue;font-family:monospace;',eBundle}}
!{{anchor HotSync Manager API Changes in 4.03}}HotSync マネージャ API の変更点 {{goto top,^TOP^}}
{{span style='color:blue;font-family:monospace;',HSAPI.h}} ファイルでは、{{goto HSConnectionType,"\"HSConnectionType\"|C/C++ Sync Suite Reference601/14"}} で説明されているように {{span style='color:blue;font-family:monospace;',HSConnectionType}} 列挙体は赤外線通信 ({{span style='color:blue;font-family:monospace;',CtIR}}) と USB ({{span style='color:blue;font-family:monospace;',CtUSB}}) 接続タイプを示すための値を含むようになりました。
!{{anchor "User Data API, Version 4.1 Changes in 4.03"}}ユーザ データ API バージョン 4.1 の変更点 {{goto top,^TOP^}}
ユーザ データ API のバージョン 4.1 は {{goto UmGetUserPassword,UmGetUserPassword()|C/C++ Sync Suite Reference601/16}} 関数の問題に取り組んでいます。暗号化されたユーザ パスワードが {{span style='color:blue;font-family:monospace;',NULL}} 文字を含んでいる場合、この関数は暗号化されたパスワードの {{span style='color:blue;font-family:monospace;',NULL}} 文字までだけを返していましたが、見込みどおりに暗号化されたパスワード全体を返すようになりました。
!!{{anchor Changes in C/C++ Sync Suite 4.02/4.02a}}C/C++ Sync Suite 4.02/4.02a の変更点 {{goto top,^TOP^}}
この節では CDK のバージョン 4.02/4.02a で変更された C/C++ Sync Suite の API と他の Feature をリスト アップします。
*{{goto "Expansion Manager and VFS Manager API, Version 1.0 Changes",拡張マネージャと VFS マネージャ バージョン 1.0 の変更点}}
*{{goto "Sync Manager API, Version 2.3 Changes",同期マネージャ API バージョン 2.3 の変更点}}
*{{goto "User Data API, Version 4.0 Changes",ユーザ データ API バージョン 4.0 の変更点}}
*{{goto "Install Aide API, Version 4.0 Changes",インストール援助機能バージョン 4.0 の変更点}}
*{{goto "Conduit Manager, Version 2 Changes",コンジット マネージャ バージョン 2 の変更点}}
*{{goto Password Library Changes,パスワード ライブラリの変更点}}
*{{goto HotSync Manager API Changes in 4.02,HotSync マネージャ API の変更点}}
!{{anchor "Expansion Manager and VFS Manager API, Version 1.0 Changes"}}拡張マネージャと VFS マネージャ バージョン 1.0 の変更点 {{goto top,^TOP^}}
バージョン 1.0 は拡張マネージャと仮想ファイル システム マネージャ API の最初のリリースです。これらのデスクトップ API のバージョン番号を取得するには {{goto VFSGetAPIVersion,VFSGetAPIVersion()|C/C++ Sync Suite Reference601/10}} を使用します。
これらの API についての詳細は、[[第 9 章 「拡張マネージャ API」|C/C++ Sync Suite Reference601/9]] と [[第 10 章 「仮想ファイル システム マネージャ API」|C/C++ Sync Suite Reference601/10]] を参照してください。
!{{anchor "Sync Manager API, Version 2.3 Changes"}}同期マネージャ API バージョン 2.3 の変更点 {{goto top,^TOP^}}
同期マネージャのバージョン 2.3 の変更点は以下の 2 つの節で説明します:
*{{goto Functions of Sync Manager,関数}}
*{{goto Change to Support More than 32 Databases,32 個以上のデータベースをサポートするための変更}}
{{anchor Functions of Sync Manager}}
'''関数'''
同期マネージャのバージョン 2.3 は {{span style='color:blue;font-family:monospace;',SyncLoopBackTest()}} 関数を追加します。これはコンジット開発者は呼び出してはいけないテスト目的のプライベート関数です。
{{anchor Change to Support More than 32 Databases}}
'''32 個以上のデータベースをサポートするための変更'''
同期マネージャのバージョン 2.3 は、あなたのコンジットが同じクリエイタ ID を持つ 32 個を超えるデータベースに関連付けられた場合に同期マネージャがクラッシュするという問題を修正しました。{{goto CSyncProperties,CSyncProperties|C/C++ Sync Suite Reference601/5-1}} クラスの中で、{{span style='color:blue;font-family:monospace;',m_RemoteName}} 配列は誤って {{span style='color:blue;font-family:monospace;',SYNC_DB_NAMELEN}} 個のエントリに制限されています。そのため、同期マネージャの以前のバージョンはあなたのコンジットがハンドヘルド上の同じクリエイタ ID を持つ 32 個を超えるデータベースに関連付けされた場合にクラッシュするかもしれません。互換性を保つためにこの制限は残っていますが、同期マネージャはデータベースの数が 32 を超えた場合に {{span style='color:blue;font-family:monospace;',m_RemoteName}} がオーバフローしたり {{span style='color:blue;font-family:monospace;',CSyncProperties}} の中のデータを破壊することを防ぐようになりました。しかしながら、あなたのコンジットが 32 個を超えるデータベースと関連付けされる場合、データベース名のリストを {{span style='color:blue;font-family:monospace;',m_RemoteName}} からではなく {{span style='color:blue;font-family:monospace;',m_RemoteDbList}} から取得するようにしてください。
!{{anchor "User Data API, Version 4.0 Changes"}}ユーザ データ API バージョン 4.0 の変更点 {{goto top,^TOP^}}
ユーザ データ API のバージョン 4.0 は Palm ハンドヘルド上の拡張スロットへのサポートを追加しました。ユーザ データ API のバージョンを見分ける方法については、{{goto User Data API Versions,「ユーザ データ API バージョン」|C/C++ Sync Suite Reference601/16}} を参照してください。
{{anchor Functions of User Data API}}
'''関数'''
個のバージョンは以下の関数をユーザ データ API に追加します:
*{{goto UmGetLibVersion,UmGetLibVersion|C/C++ Sync Suite Reference601/16}}
*{{goto UmSlotGetDisplayName,UmSlotGetDisplayName|C/C++ Sync Suite Reference601/16}}
*{{goto UmSlotGetExpMgrVersion,UmSlotGetExpMgrVersion|C/C++ Sync Suite Reference601/16}}
*{{goto UmSlotGetInfo,UmSlotGetInfo|C/C++ Sync Suite Reference601/16}}
*{{goto UmSlotGetInstallDirectory,UmSlotGetInstallDirectory|C/C++ Sync Suite Reference601/16}}
*{{goto UmSlotGetMediaType,UmSlotGetMediaType|C/C++ Sync Suite Reference601/16}}
*{{goto UmSlotGetSlotCount,UmSlotGetSlotCount|C/C++ Sync Suite Reference601/16}}
バージョン 4.0 では、{{goto UmGetUserID,UmGetUserID()|C/C++ Sync Suite Reference601/16}} は成功した場合に 0 を返し、{{span style='color:blue;font-family:monospace;',pdwUserID}} にユーザ ID を戻します; 失敗した場合は負のエラー コードを返します。4.0 よりも前のバージョンでは、{{span style='color:blue;font-family:monospace;',UmGetUserID()}} は成功した場合にユーザ ID (キャストされる前は正負どちらにでもなりうる値) を返し、同じ値を {{span style='color:blue;font-family:monospace;',pdwUserID}} に戻しました; 失敗した場合、ユーザ ID が見つからなかった場合は 0 を、エラーが起きた場合は負の値を返しました。そのため、負の返り値はエラーを示しているかもしれませんし、そうではないかもしれなかったのです。バージョン 4.0 はこの問題を修正しました。
{{anchor Error Codes of User Data API}}
'''エラー コード'''
バージョン 4.0 は以下のエラー コードを追加します:
{{goto ERR_UM_DEV_CFG_DATA_NOT_AVAILABLE,ERR_UM_DEV_CFG_DATA_NOT_AVAILABLE|C/C++ Sync Suite Reference601/16}}
!{{anchor "Install Aide API, Version 4.0 Changes"}}インストール援助機能バージョン 4.0 の変更点 {{goto top,^TOP^}}
このバージョンのインストール援助機能 API は Palm ハンドヘルド上の拡張スロットへのサポートを追加します。
{{anchor Functions Install Aide API}}
'''関数'''
このバージョンはインストール援助機能 API に以下の関数を追加します:
*{{goto PlmGetLibVersion,PlmGetLibVersion()|C/C++ Sync Suite Reference601/15}}
*{{goto PlmMoveInstallFileToHandheld,PlmMoveInstallFileToHandheld()|C/C++ Sync Suite Reference601/15}}
*{{goto PlmMoveInstallFileToSlot,PlmMoveInstallFileToSlot()|C/C++ Sync Suite Reference601/15}}
*{{goto PlmSlotGetFileCount,PlmSlotGetFileCount()|C/C++ Sync Suite Reference601/15}}
*{{goto PlmSlotGetFileInfo,PlmSlotGetFileInfo()|C/C++ Sync Suite Reference601/15}}
*{{goto PlmSlotInstallFile,PlmSlotInstallFile()|C/C++ Sync Suite Reference601/15}}
*{{goto PlmSlotMoveInstallFile,PlmSlotMoveInstallFile()|C/C++ Sync Suite Reference601/15}}
*{{goto PlmSlotRemoveInstallFile,PlmSlotRemoveInstallFile()|C/C++ Sync Suite Reference601/15}}
*{{goto PltGetInstallFileFilterForUser,PltGetInstallFileFilterForUser()|C/C++ Sync Suite Reference601/15}}
バージョン 4.0 では、{{goto PltRemoveInstallFile,PltRemoveInstallFile()|C/C++ Sync Suite Reference601/15}} は失敗した場合に {{span style='color:blue;font-family:monospace;',ERR_PALM_FILE_DELETE_FAILED}} を返します。これより前のバージョンでは、この関数は指定されたファイルが存在しない場合にエラー メッセージを返しませんでした。
C/C++ Sync Suite のバージョン 4.02 では、{{span style='color:blue;font-family:monospace;',InstAide.dll}} で利用可能な関数はすべて {{span style='color:blue;font-family:monospace;',InstAppd.h}} ではなく {{span style='color:blue;font-family:monospace;',InstAide.h}} で宣言されています。{{span style='color:blue;font-family:monospace;',InstAide.h}} をインクルードするようあなたのソースをアップデートしてください。
{{anchor Error Codes of Install Aide API}}
'''エラー コード'''
このバージョンは以下のエラー コードを追加します:
*{{goto ERR_PALM_FILE_DELETE_FAILED,ERR_PALM_FILE_DELETE_FAILED|C/C++ Sync Suite Reference601/15}}
*{{goto ERR_PALM_FILE_MOVE_FAILED,ERR_PALM_FILE_MOVE_FAILED|C/C++ Sync Suite Reference601/15}}
!{{anchor "Conduit Manager, Version 2 Changes"}}コンジット マネージャ バージョン 2 の変更点 {{goto top,^TOP^}}
このバージョンのコンジット マネージャはインストール コンジット マネージャと通知機能インストール マネージャの関数を含みます。3 つのマネージャの関数はすべて {{span style='color:blue;font-family:monospace;',CondMgr.dll}} で利用可能です。
C/C++ Sync Suite のバージョン 4.02 では、{{span style='color:blue;font-family:monospace;',CondMgr.dll}} で利用可能な関数はすべて {{span style='color:blue;font-family:monospace;',CondMgre.h}} ではなく {{span style='color:blue;font-family:monospace;',CondMgr.h}} で宣言されています。{{span style='color:blue;font-family:monospace;',CondMgr.h}} をインクルードするようにあなたのソースをアップデートしてください。
{{anchor New Functions}}
'''新しい関数'''
このバージョンは以下の新しいインストール コンジット マネージャ関数と通知機能インストール マネージャ関数を追加します:
*{{goto ImGetDirectory,ImGetDirectory()|C/C++ Sync Suite Reference601/12}}
*{{goto ImGetDWord,ImGetDWord()|C/C++ Sync Suite Reference601/12}}
*{{goto ImGetExtension,ImGetExtension()|C/C++ Sync Suite Reference601/12}}
*{{goto ImGetMask,ImGetMask()|C/C++ Sync Suite Reference601/12}}
*{{goto ImGetModule,ImGetModule()|C/C++ Sync Suite Reference601/12}}
*{{goto ImGetName,ImGetName()|C/C++ Sync Suite Reference601/12}}
*{{goto ImGetString,ImGetString()|C/C++ Sync Suite Reference601/12}}
*{{goto ImRegister,ImRegister()|C/C++ Sync Suite Reference601/12}}
*{{goto ImRegisterID,ImRegisterID()|C/C++ Sync Suite Reference601/12}}
*{{goto ImSetDirectory,ImSetDirectory()|C/C++ Sync Suite Reference601/12}}
*{{goto ImSetDWord,ImSetDWord()|C/C++ Sync Suite Reference601/12}}
*{{goto ImSetExtension,ImSetExtension()|C/C++ Sync Suite Reference601/12}}
*{{goto ImSetMask,ImSetMask()|C/C++ Sync Suite Reference601/12}}
*{{goto ImSetModule,ImSetModule()|C/C++ Sync Suite Reference601/12}}
*{{goto ImSetName,ImSetName()|C/C++ Sync Suite Reference601/12}}
*{{goto ImSetString,ImSetString()|C/C++ Sync Suite Reference601/12}}
*{{goto ImUnregisterID,ImUnregisterID()|C/C++ Sync Suite Reference601/12}}
*{{goto NmFind,NmFind()|C/C++ Sync Suite Reference601/13}}
*{{goto NmGetByIndex,NmGetByIndex()|C/C++ Sync Suite Reference601/13}}
*{{goto NmGetCount,NmGetCount()|C/C++ Sync Suite Reference601/13}}
*{{goto NmRegister,NmRegister()|C/C++ Sync Suite Reference601/13}}
*{{goto NmRenameByIndex,NmRenameByIndex()|C/C++ Sync Suite Reference601/13}}
*{{goto NmUnregister,NmUnregister()|C/C++ Sync Suite Reference601/13}}
{{anchor Deprecated Functions}}
'''使用を推奨されなくなった関数'''
通知機能インストール マネージャは通知機能を扱うための関数を導入したため、コンジット マネージャ API のバージョン 2 では以下の関数の使用が推奨されなくなりました:
*{{span style='color:blue;font-family:monospace;',CmSetNotifierDll()}}
*{{span style='color:blue;font-family:monospace;',CmGetNotifierDll()}}
これらの関数はコンジット マネージャ API のバージョン 2 でも機能し続けますが、将来は機能しなくなるかもしれません。そのため、これらの関数の代わりに通知機能インストール マネージャ関数を使用してください。詳細は [[第 13 章 「通知機能インストール マネージャ API」|C/C++ Sync Suite Reference601/13]] を参照してください。
{{anchor New Error Codes}}
'''新しいエラー コード'''
このバージョンのコンジット マネージャは以下のエラー コードを追加します:
*{{goto ERR_ALREADY_INSTALLED,ERR_ALREADY_INSTALLED|C/C++ Sync Suite Reference601/11-3}}
*{{goto ERR_CREATORID_ALREADY_IN_USE,ERR_CREATORID_ALREADY_IN_USE|C/C++ Sync Suite Reference601/11-3}}
*{{goto ERR_INVALID_INSTALL_ID,ERR_INVALID_INSTALL_ID|C/C++ Sync Suite Reference601/11-3}}
*{{goto ERR_INVALID_PATH,ERR_INVALID_PATH|C/C++ Sync Suite Reference601/11-3}}
*{{goto ERR_NOTIFIER_NOT_FOUND,ERR_NOTIFIER_NOT_FOUND|C/C++ Sync Suite Reference601/11-3}}
*{{goto ERR_STORAGE_ACCESS,ERR_STORAGE_ACCESS|C/C++ Sync Suite Reference601/11-3}}
!{{anchor Password Library Changes}}パスワード ライブラリの変更点 {{goto top,^TOP^}}
パスワード暗号化アルゴリズムは Palm OS バージョン 4.0 で変更されました。さらに、Palm OS 4.0 以降では、デバイス上のパスワードは大文字/小文字を区別されるようになりました; そのため、{{span style='color:blue;font-family:monospace;',PwdVerify()}} はユーザの提供した文字列が - 大文字/小文字の区別も含めて - 保存されているパスワードと一致する場合にのみ {{span style='color:blue;font-family:monospace;',true}} を返すようになりました。更なる情報は、{{goto PwdVerify,PwdVerify()|C/C++ Sync Suite Reference601/17}} の説明を参照してください。
!{{anchor HotSync Manager API Changes in 4.02}}HotSync マネージャ API の変更点 {{goto top,^TOP^}}
{{goto HsRefreshConduitInfo,HsRefreshConduitInfo()|C/C++ Sync Suite Reference601/14}} 関数が HotSync マネージャ API に追加されました。
{{div_end}}
{{div_begin "style='border-top-style:solid;border-top-width:1px;border-top-color:silver;'"}}
[[← 18 章に戻る|C/C++ Sync Suite Reference601/18]] [[↑トップへ|C/C++ Sync Suite Reference601]] [[付録 B に進む →|C/C++ Sync Suite Reference601/B]]
{{div_end}}
