{{div_begin}} [[←　3 章に戻る|C/C++ Sync Suite Reference601/3]]　[[↑トップへ|C/C++ Sync Suite Reference601]]　[[5 章に進む　→|C/C++ Sync Suite Reference601/5]] {{div_end}} {{div_begin style="margin-bottom:-10px"}} !!!4 クラシック同期マネージャ API (ページ 1) {{div_end}} {{div_begin "style='position:absolute;right:0px;font-size:70%;margin-right:15px;margin-top:15px;width:250px;'"}} *{{goto Classic Sync Manager Classes,クラシック同期マネージャクラス}} **{{goto CCallModuleParams,CCallModuleParams}} **{{goto CDbCreateDB,CDbCreateDB}} **{{goto CDbGenInfo,CDbGenInfo}} **{{goto CPositionInfo,CPositionInfo}} **{{goto CRawPreferenceInfo,CRawPreferenceInfo}} **{{goto CRawRecordInfo,CRawRecordInfo}} *{{goto Classic Sync Manager Structures and Types,クラシック同期マネージャ構造体とタイプ}} **{{goto SyncDatabaseInfoType,SyncDatabaseInfoType}} **{{goto SyncFindDbByNameParams,SyncFindDbByNameParams}} **{{goto SyncFindDbByTypeCreatorParams,SyncFindDbByTypeCreatorParams}} **{{goto SyncReadOpenDbInfoParams,SyncReadOpenDbInfoParams}} *{{goto Classic Sync Manager Constants,クラシック同期マネージャ定数}} **{{goto Deprecated Constants,使用を推奨されなくなった定数}} *{{goto Classic Sync Manager Functions,クラシック同期マネージャ関数}} **{{goto SyncCallRemoteModule,SyncCallRemoteModule}} **{{goto SyncChangeCategory,SyncChangeCategory}} **{{goto SyncCloseDB,SyncCloseDB}} **{{goto SyncCloseDBEx,SyncCloseDBEx}} **{{goto SyncCreateDB,SyncCreateDB}} **{{goto SyncDeleteAllResourceRec,SyncDeleteAllResourceRec}} **{{goto SyncDeleteDB,SyncDeleteDB}} **{{goto SyncDeleteRec,SyncDeleteRec}} **{{goto SyncDeleteResourceRec,SyncDeleteResourceRec}} **{{goto SyncFindDbByName,SyncFindDbByName}} **{{goto SyncFindDbByTypeCreator,SyncFindDbByTypeCreator}} **{{goto SyncGetDBRecordCount,SyncGetDBRecordCount}} **{{goto SyncMaxRemoteRecSize,SyncMaxRemoteRecSize}} **{{goto SyncOpenDB,SyncOpenDB}} **{{goto SyncPurgeAllRecs,SyncPurgeAllRecs}} **{{goto SyncPurgeAllRecsInCategory,SyncPurgeAllRecsInCategory}} **{{goto SyncPurgeDeletedRecs,SyncPurgeDeletedRecs}} **{{goto SyncReadAppPreference,SyncReadAppPreference|C/C++ Sync Suite Reference601/4-2}} **{{goto SyncReadDBAppInfoBlock,SyncReadDBAppInfoBlock|C/C++ Sync Suite Reference601/4-2}} **{{goto SyncReadDBList,SyncReadDBList|C/C++ Sync Suite Reference601/4-2}} **{{goto SyncReadDBSortInfoBlock,SyncReadDBSortInfoBlock|C/C++ Sync Suite Reference601/4-2}} **{{goto SyncReadNextModifiedRec,SyncReadNextModifiedRec|C/C++ Sync Suite Reference601/4-2}} **{{goto SyncReadNextModifiedRecInCategory,SyncReadNextModifiedRecInCategory|C/C++ Sync Suite Reference601/4-2}} **{{goto SyncReadNextRecInCategory,SyncReadNextRecInCategory|C/C++ Sync Suite Reference601/4-2}} **{{goto SyncReadOpenDbInfo,SyncReadOpenDbInfo|C/C++ Sync Suite Reference601/4-2}} **{{goto SyncReadPositionXMap,SyncReadPositionXMap|C/C++ Sync Suite Reference601/4-2}} **{{goto SyncReadRecordById,SyncReadRecordById|C/C++ Sync Suite Reference601/4-2}} **{{goto SyncReadRecordByIndex,SyncReadRecordByIndex|C/C++ Sync Suite Reference601/4-2}} **{{goto SyncReadResRecordByIndex,SyncReadResRecordByIndex|C/C++ Sync Suite Reference601/4-2}} **{{goto SyncResetRecordIndex,SyncResetRecordIndex|C/C++ Sync Suite Reference601/4-2}} **{{goto SyncResetSyncFlags,SyncResetSyncFlags|C/C++ Sync Suite Reference601/4-2}} **{{goto SyncWriteAppPreference,SyncWriteAppPreference|C/C++ Sync Suite Reference601/4-2}} **{{goto SyncWriteDBAppInfoBlock,SyncWriteDBAppInfoBlock|C/C++ Sync Suite Reference601/4-2}} **{{goto SyncWriteDBSortInfoBlock,SyncWriteDBSortInfoBlock|C/C++ Sync Suite Reference601/4-2}} **{{goto SyncWriteRec,SyncWriteRec|C/C++ Sync Suite Reference601/4-2}} **{{goto SyncWriteResourceRec,SyncWriteResourceRec|C/C++ Sync Suite Reference601/4-2}} {{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;'"}} [[↑　4 章のトップへ|C/C++ Sync Suite Reference601/4]]　[[4 章のページ 2 へ　→|C/C++ Sync Suite Reference601/4-2]] !!{{anchor Classic Sync Manager Classes}}クラシック同期マネージャクラス {{goto top,^TOP^}} この節では、以下のクラス - {{goto Classic Sync Manager Functions,「クラシック同期マネージャ関数」}} で説明されているクラシック同期マネージャ関数だけがパラメータとしてとる - について説明します。クラシック同期マネージャ関数とともに拡張同期マネージャ関数も使用する追加のクラスについては {{goto Common Sync Manager Classes,「共通同期マネージャクラス」|C/C++ Sync Suite Reference601/5}} で説明します。これらのクラスはデータメンバを定義しているだけで、メソッドは定義していません。同期マネージャバージョン 2.4 で導入された関数はこれらのクラスを使用しません。 //*{{goto CCallModuleParams,CCallModuleParams}} - {{span style='color:blue;font-family:monospace;',SyncCalRemoteModule()}} がハンドヘルドのアプリケーション/モジュールとやりとりする情報を定義します。 //*{{goto CDbCreateDB,CDbCreateDB}} - {{span style='color:blue;font-family:monospace;',SyncCreateDB()}} 関数で作成されるデータベースについての情報を定義します。 //*{{goto CDbGenInfo,CDbGenInfo}} - データベースヘッダの中のアプリケーション情報ブロックまたはソート情報ブロックについての情報を定義します。 //*{{goto CPositionInfo,CPositionInfo}} - {{span style='color:blue;font-family:monospace;',SyncReadPositionXMap()}} 関数がハンドヘルド上のデータベースからソートされたレコード ID のリストを取得する方法を定義します。 //*{{goto CRawPreferenceInfo,CRawPreferenceInfo}} - アプリケーション設定ブロック（64 K バイトよりも小さく、{{span style='color:blue;font-family:monospace;',SyncReadAppPreference()}} と {{span style='color:blue;font-family:monospace;',SyncWriteAppPreference()}} でアクセスされます）を定義します。 //*{{goto CRawRecordInfo,CRawRecordInfo}} - {{span style='color:blue;font-family:monospace;',SyncCreateDB()}} 関数で作成されるデータベースについての情報を定義します。 ,クラス,説明 ,"{{goto CCallModuleParams,CCallModuleParams}}","{{span style='color:blue;font-family:monospace;',SyncCalRemoteModule()}} がハンドヘルドのアプリケーション/モジュールとやりとりする情報を定義します。" ,"{{goto CDbCreateDB,CDbCreateDB}}","{{span style='color:blue;font-family:monospace;',SyncCreateDB()}} 関数で作成されるデータベースについての情報を定義します。" ,"{{goto CDbGenInfo,CDbGenInfo}}","データベースヘッダの中のアプリケーション情報ブロックまたはソート情報ブロックについての情報を定義します。" ,"{{goto CPositionInfo,CPositionInfo}}","{{span style='color:blue;font-family:monospace;',SyncReadPositionXMap()}} 関数がハンドヘルド上のデータベースからソートされたレコード ID のリストを取得する方法を定義します。" ,"{{goto CRawPreferenceInfo,CRawPreferenceInfo}}","アプリケーション設定ブロック（64 K バイトよりも小さく、{{span style='color:blue;font-family:monospace;',SyncReadAppPreference()}} と {{span style='color:blue;font-family:monospace;',SyncWriteAppPreference()}} でアクセスされます）を定義します。" ,"{{goto CRawRecordInfo,CRawRecordInfo}}","{{span style='color:blue;font-family:monospace;',SyncCreateDB()}} 関数で作成されるデータベースについての情報を定義します。" !{{anchor CCallModuleParams}}CCallModuleParams {{goto top,^TOP^}} '''目的''' {{goto SyncCallRemoteModule,SyncCallRemoteModule()}} がハンドヘルド上のアプリケーション/モジュールとやり取りする情報を定義します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' class CCallModuleParams { public: UInt32 m_dwCreatorID; UInt32 m_dwTypeID; UInt16 m_wActionCode; UInt32 m_dwParamSize; void *m_pParam; UInt32 m_dwResultBufSize; void *m_pResultBuf; UInt32 m_dwResultCode; UInt32 m_dwActResultSize; UInt32 m_dwReserved; } '''データメンバ''' *{{span style='color:blue;font-family:monospace;',m_dwCreatorID}} **ターゲットのハンドヘルドアプリケーションの作成者 ID を指定します。 *{{span style='color:blue;font-family:monospace;',m_dwTypeID}} **ターゲットのハンドヘルドアプリケーションのタイプ ID を指定します。 *{{span style='color:blue;font-family:monospace;',m_wActionCode}} **実行するアプリケーション-指定アクションコードを指定します。 *{{span style='color:blue;font-family:monospace;',m_dwParamSize}} **{{span style='color:blue;font-family:monospace;',m_pParam}} 配列のバイト数を指定します。 *{{span style='color:blue;font-family:monospace;',m_pParam}} **パラメータブロックへのポインタを指定します。 *{{span style='color:blue;font-family:monospace;',m_dwResultBufSize}} **{{span style='color:blue;font-family:monospace;',m_pResultBuf}} 配列のトータルのバイト数を指定します。 *{{span style='color:blue;font-family:monospace;',m_pResultBuf}} **結果を収めるバッファへのポインタを指定します。 *{{span style='color:blue;font-family:monospace;',m_dwResultCode}} **ハンドヘルドアプリケーション/モジュールによって返される結果コードを受け取ります。 *{{span style='color:blue;font-family:monospace;',m_dwActResultSize}} **結果のデータの実際のサイズを受け取ります。 *{{span style='color:blue;font-family:monospace;',m_dwReserved}} **将来使用するために予約されています。呼び出し元は同期マネージャ関数を呼び出す前にこのメンバに {{span style='color:blue;font-family:monospace;',NULL}} （{{span style='color:blue;font-family:monospace;',0}}）をセットしなければなりません。 '''コメント''' {{span style='color:blue;font-family:monospace;',m_pResultBuf}} が指すバッファがすべてのデータを収容するのに十分な大きさがない場合、{{span style='color:blue;font-family:monospace;',m_dwActResultSize}} の値は {{span style='color:blue;font-family:monospace;',m_dwResultBufSize}} の値よりも大きくなります。この場合、関数はデータの {{span style='color:blue;font-family:monospace;',m_dwResultBufSize}} バイト分だけをバッファにコピーします。 '''互換性''' 同期マネージャバージョン: 2.1 以降 *Palm OS バージョン: Palm OS 2.0 以降 !{{anchor CDbCreateDB}}CDbCreateDB {{goto top,^TOP^}} '''目的''' {{goto SyncCreateDB,SyncCreateDB()}} 関数で作成されるデータベースについての情報を定義します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' class CDbCreateDB { public: HSByte m_FileHandle; UInt32 m_Creator; eDbFlags m_Flags; HSByte m_CardNo; char m_Name[SYNC_DB_NAMELEN]; UInt32 m_Type; UInt16 m_Version; UInt32 m_dwReserved; } '''データメンバ''' *{{span style='color:blue;font-family:monospace;',m_FileHandle}} **作成されたデータベースへのハンドルを取得します。 *{{span style='color:blue;font-family:monospace;',m_Creator}} **作成されるデータベースの 4 バイトの作成者 ID を指定します。アプリケーションをリリースする前に、作成者 ID を PalmSource の Web サイトに登録しなくてはなりません。PalmSource 社はすべて小文字で構成される作成者 ID を予約しています。 *{{span style='color:blue;font-family:monospace;',m_Flags}} **作成されるデータベースについてのいくつかの特性を指定する {{goto eDbFlags,eDbFlags|C/C++ Sync Suite Reference601/5}} 値（クラシックレコードデータベースまたはリソースデータベースかスキーマデータベースかに関係なく、そのデータベースがバックアップされるかどうかに関係なく、など）。 *{{span style='color:blue;font-family:monospace;',m_CardNo}} **データベースが保存されるメモリカードの番号を指定します。システムの最初のメモリカードはカード番号 0 で、その後に続くカード番号は +1 ずつ増加します。複数の PalmOS メモリカードをサポートする唯一のハンドヘルドであるある特定の HandSpring ハンドヘルドを除き、常に 0 を指定します。 *{{span style='color:blue;font-family:monospace;',m_Name}} **作成されるデータベースの名前をサイズ {{span style='color:blue;font-family:monospace;',SYNC_DB_NAMELEN}} の文字配列として指定します。 *{{span style='color:blue;font-family:monospace;',m_Type}} **4 バイトのデータベースタイプを指定します。Palm OS は特定の機能をいくつかの識別値 - {{span style='color:blue;font-family:monospace;',"'DATA', 'data', 'appl', 'panl', 'libr'"}} を含む - と関連付けます。 *{{span style='color:blue;font-family:monospace;',m_Version}} **新しいデータベースのためのアプリケーション指定バージョン番号を指定します。 *{{span style='color:blue;font-family:monospace;',m_dwReserved}} **将来使用するために予約されています。あなたは {{goto SyncCreateDB,SyncCreateDB()}} を呼び出す前にこの値に {{span style='color:blue;font-family:monospace;',NULL}} (0) をセットしなくてはなりません。 '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: すべて '''参照''' {{goto SyncCreateDB,SyncCreateDB()}} !{{anchor CDbGenInfo}}CDbGenInfo {{goto top,^TOP^}} '''目的''' データベースヘッダの中にある {{goto application info,アプリケーション情報|Introduction to Conduit Development601/Glossary}} ブロックまたはソート情報ブロックについての情報を定義します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' class CDbGenInfo { public: char m_FileName[SYNC_DB_NAMELEN]; UInt16 m_TotalBytes; UInt16 m_BytesRead; HSByte *m_pBytes; UInt32 m_dwReserved; } '''データメンバ''' *{{span style='color:blue;font-family:monospace;',m_FileName}} **ハンドヘルドデータベースの名前を null で終了する文字列で指定します。Note: このメンバは、{{goto SyncReadDBAppInfoBlock,SyncReadDBAppInfoBlock()|C/C++ Sync Suite Reference601/4-2}}, {{goto SyncReadDBSortInfoBlock,SyncReadDBSortInfoBlock()|C/C++ Sync Suite Reference601/4-2}}, {{goto SyncWriteDBAppInfoBlock,SyncWriteDBAppInfoBlock()|C/C++ Sync Suite Reference601/4-2}}, {{goto SyncWriteDBSortInfoBlock,SyncWriteDBSortInfoBlock()|C/C++ Sync Suite Reference601/4-2}} 関数では使用されません。 *{{span style='color:blue;font-family:monospace;',m_TotalBytes}} **{{span style='color:blue;font-family:monospace;',m_pBytes}} 配列のトータルのバイト数を指定します。読み込み時には、呼び出し元はまずこのメンバに {{span style='color:blue;font-family:monospace;',m_pBytes}} によって指されるバッファのサイズを指定します。書き込み時は、呼び出し元はまずこのメンバと {{span style='color:blue;font-family:monospace;',m_BytesRead}} にブロックのうち書き込むサイズを指定します。 *{{span style='color:blue;font-family:monospace;',m_BytesRead}} **{{span style='color:blue;font-family:monospace;',m_pBytes}} 配列の中の有用なバイト数を定義します。バージョン特有の振る舞いについては以下のコメントを参照してください。 *{{span style='color:blue;font-family:monospace;',m_pBytes}} **呼び出し元がアプリケーション情報ブロックデータまたはソート情報ブロックデータのために割り当てたバッファへのポインタを指定します。 *{{span style='color:blue;font-family:monospace;',m_dwReserved}} **将来使用するために予約されています。呼び出し元は同期マネージャ関数を呼び出す前に、このメンバに {{span style='color:blue;font-family:monospace;',NULL}} (0) をセットします。 '''コメント''' アプリケーション情報ブロックまたはソート情報ブロックを読み込むとき、呼び出し元は {{span style='color:blue;font-family:monospace;',m_TotalBytes}} の値に {{span style='color:blue;font-family:monospace;',m_pBytes}} によって指されるバッファのサイズを代入しなければなりません。アプリケーション情報ブロックまたはソート情報ブロックがバッファよりも大きい場合同期マネージャ関数は {{span style='color:blue;font-family:monospace;',m_BytesRead}} にアプリケーション情報ブロックまたはソート情報ブロックの実際のサイズ - これは同期マネージャ関数が {{span style='color:blue;font-family:monospace;',m_pBytes}} バッファにコピーするデータの量よりも大きくなる可能性があります - を代入します。この場合同期マネージャのバージョン 2.1 以降は、データの先頭から {{span style='color:blue;font-family:monospace;',m_TotalBytes}} 分だけを呼び出し元のバッファにコピーします; バージョン 2.1 よりも前では、呼び出し元のバッファに何もコピーしません。アプリケーション情報ブロックまたはソート情報ブロックを書き込むとき、呼び出し元はまず {{span style='color:blue;font-family:monospace;',m_TotalBytes}} と {{span style='color:blue;font-family:monospace;',m_BytesRead}} の両方に書き込むデータのサイズをセットしなくてはなりません。 '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: すべてバージョンの違いによる動作の違いは「コメント」を参照してください。 '''参照''' {{goto SyncReadDBAppInfoBlock,SyncReadDBAppInfoBlock()|C/C++ Sync Suite Reference601/4-2}}, {{goto SyncReadDBSortInfoBlock,SyncReadDBSortInfoBlock()|C/C++ Sync Suite Reference601/4-2}}, {{goto SyncWriteDBAppInfoBlock,SyncWriteDBAppInfoBlock()|C/C++ Sync Suite Reference601/4-2}}, {{goto SyncWriteDBSortInfoBlock,SyncWriteDBSortInfoBlock()|C/C++ Sync Suite Reference601/4-2}} !{{anchor CPositionInfo}}CPositionInfo {{goto top,^TOP^}} '''目的''' {{goto SyncReadPositionXMap,SyncReadPositionXMap()|C/C++ Sync Suite Reference601/4-2}} 関数がどのようにハンドヘルド上のデータベースからソートされたレコード ID のリストを取得するかを定義します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' class CPositionInfo { public: HSByte m_FileHandle; UInt16 m_FirstPos; UInt16 m_MaxEntries; UInt16 m_NumReadIn; UInt16 m_TotalBytes; HSByte *m_pBytes; } '''データメンバ''' *{{span style='color:blue;font-family:monospace;',m_FileHandle}} **オープンされているクラシックデータベースのハンドルを指定します。 *{{span style='color:blue;font-family:monospace;',m_FirstPos}} **読み込む最初のレコード ID のインデックスを指定します。このインデックスはゼロベースです。 *{{span style='color:blue;font-family:monospace;',m_MaxEntries}} **読み込むレコード ID の総数を指定します。この値は {{span style='color:blue;font-family:monospace;',m_TotalBytes}} メンバの値と矛盾の無いものでなければならないことに注意してください: 各レコード ID は 4 バイトなので、{{span style='color:blue;font-family:monospace;',m_TotalBytes}} の値は {{span style='color:blue;font-family:monospace;',n_MaxEntries * 4}} と等しくなければなりません。 *{{span style='color:blue;font-family:monospace;',m_NumReadIn}} **レコード ID の数を受け取ります。{{span style='color:blue;font-family:monospace;',m_pBytes}} 配列で戻されるバイトのバイト数ではありません。 *{{span style='color:blue;font-family:monospace;',m_TotalBytes}} **{{span style='color:blue;font-family:monospace;',m_pBytes}} によって指されるバッファのバイト数を指定します。この値は {{span style='color:blue;font-family:monospace;',n_MaxEntries}} メンバの値と矛盾の無いものでなければならないことに注意してください: 各レコード ID は 4 バイトなので、{{span style='color:blue;font-family:monospace;',m_TotalBytes}} の値は {{span style='color:blue;font-family:monospace;',n_MaxEntries * 4}} と等しくなければなりません。 *{{span style='color:blue;font-family:monospace;',*m_pBytes}} **レコード ID を受け取るためのバイトの配列を指すポインタを指定します。呼び出し元は {{span style='color:blue;font-family:monospace;',SyncReadPositionXMap()}} を呼び出す前に割り当てこのバイトに割り当てを行わなければなりません。 '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: すべて {{goto "Sync Manager API, Version 2.4 Changes"同期マネージャ API バージョン 2.4 の変更点|C/C++ Sync Suite Reference601/A}} を参照してください。 '''参照''' {{goto SyncReadPositionXMap,SyncReadPositionXMap()|C/C++ Sync Suite Reference601/4-2}} !{{anchor CRawPreferenceInfo}}CRawPreferenceInfo {{goto top,^TOP^}} '''目的''' {{goto application preferences,アプリケーション設定|Introduction to Conduit Development601/Glossary}} ブロック - これは 64 K バイトよりも小さく、{{goto SyncReadApPreference,SyncReadPreference()|C/C++ Sync Suite Reference601/4-2}} と {{goto SyncWritePreference,SyncWritePreference()|C/C++ Sync Suite Reference601/4-2}} でアクセスされます - を定義します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' class CRawPreferenceInfo { public: UInt16 m_version; UInt32 m_creator; UInt16 m_prefId; UInt16 m_reqBytes; UInt16 m_retBytes; UInt16 m_actSize; SInt32 m_backedUp; SInt32 m_nBytes; HSByte *m_pBytes; UInt32 m_dwReserved; } '''データメンバ''' *{{span style='color:blue;font-family:monospace;',m_version}} **設定のバージョン。書き込み時には、このメンバは呼び出し元によって指定されます。読み込み時には、ハンドヘルドから値を受け取ります。 *{{span style='color:blue;font-family:monospace;',m_creator}} **アクセスする設定作成者 ID を指定します。通常、この値はアプリケーションの作成者 ID と同じです。 *{{span style='color:blue;font-family:monospace;',m_prefId}} **アクセスする設定 ID を指定します。 *{{span style='color:blue;font-family:monospace;',m_reqBytes}} **読み込み時には、このメンバは要求する設定の最大バイト数を指定します（値 0xFFFF はすべての設定情報を要求します）。この値は {{span style='color:blue;font-family:monospace;',m_nBytes}} の値よりも大きくなってはいけません。書き込み時には、このメンバは無視されます。 *{{span style='color:blue;font-family:monospace;',m_retBytes}} **読み込み時には、このメンバは呼び出し元のバッファにコピーされた設定のバイト数を受け取ります。書き込み時には、このメンバは無視されます。 *{{span style='color:blue;font-family:monospace;',m_actSize}} **読み込み時には、このメンバはハンドヘルド上の設定の実際のサイズを受け取ります。呼び出し元のバッファの大きさが十分ではない場合、この値は {{span style='color:blue;font-family:monospace;',m_nBytes}} よりも大きくなる可能性があります。書き込み時には、このメンバは無視されます。 *{{span style='color:blue;font-family:monospace;',m_backedUp}} *同期マネージャ関数が ''保存される'' (原文: Saves) 設定データベース - これは HotSync 実施中にバックアップされます - にアクセスする ({{span style='color:blue;font-family:monospace;',TRUE}}) のか、それとも ''保存されない'' (原文: Unsaved) 設定データベース - これはバックアップされません - にアクセスするのかを指定します。 *{{span style='color:blue;font-family:monospace;',m_nBytes}} **読み込み時には、このメンバは呼び出し元によって割り当てられる {{span style='color:blue;font-family:monospace;',m_pBytes}} 配列のサイズ - バイト数 - を指定します。書き込み時には、このメンバは書き込む設定データのバイト数を指定します。 *{{span style='color:blue;font-family:monospace;',m_pBytes}} **設定情報のためのデータバッファとして使用するバイト配列へのポインタを指定します。読み込み時には、このバッファは要求したデータを受け取ります。書き込み時には、このバッファは書き込むデータを保持します。どちらの場合でも、呼び出し元は同期マネージャ関数を呼び出す前にこのバッファを割り当てなければなりません。 *{{span style='color:blue;font-family:monospace;',m_dwReserved}} **将来使用するために予約されています。呼び出し元は同期マネージャ関数を呼び出す前にこのメンバに {{span style='color:blue;font-family:monospace;',NULL (0)}} をセットしなければなりません。 '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: 2.0 以降 '''参照''' {{goto SyncReadAppPreference,SyncReadAppPreference()|C/C++ Sync Suite Reference601/4-2}}, {{goto SyncWriteAppPreference,SyncWriteAppPreference()|C/C++ Sync Suite Reference601/4-2}} !{{anchor CRawRecordInfo}}CRawRecordInfo {{goto top,^TOP^}} '''目的''' クラシックレコードデータベースまたはリソースデータベースのレコードの構造を定義します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' class CRawRecordInfo { public: HSByte m_FileHandle; UInt32 m_RecId; UInt16 m_RecIndex; HSByte m_Attribs; SInt16 m_CatId; SInt32 m_ConduitId; UInt32 m_RecSize; UInt16 m_TotalBytes; HSByte *m_pBytes; UInt32 m_dwReserved; } '''データメンバ''' *{{span style='color:blue;font-family:monospace;',m_FileHandle}} **ハンドヘルド上のオープンされているクラシックデータベースのハンドルを指定します。これは {{goto SyncCreateDB,SyncCreateDB()}} または {{goto SyncOpenDB,SyncOpenDB()}} 関数によって返されるハンドルです。 *{{span style='color:blue;font-family:monospace;',m_RecId}} **クラシックレコードデータベースのレコード ID またはリソースデータベースのリソースタイプを定義します。ID による読み込み時または削除時には、呼び出し元はこのメンバを指定します。インデックス（またはデータベースの最初から最後までの反復操作）による読み込み時には、このメンバはハンドヘルドからレコード ID を受け取ります。リソースの削除時には、このメンバはリソースタイプを指定します。書き込み時には、このメンバはレコード ID - これは常にハンドヘルドによって代入されます - を受け取ります。 *{{span style='color:blue;font-family:monospace;',m_RecIndex}} **レコードインデックスを定義します。インデックスによるレコードまたはリソースの読み込み時には、呼び出し元がこのメンバを指定します。リソースの読み込み時には、このメンバはハンドヘルドからリソース ID を受け取ります。リソースの削除時には、このメンバはリソース ID を指定します同期マネージャバージョン 2.1 以降を使用しての ID によるレコードの読み込み時には、このメンバはハンドヘルドからレコードインデックスを受け取ります同期マネージャバージョン 2.1 よりも前では、この値は定義されません。 *{{span style='color:blue;font-family:monospace;',m_Attribs}} **レコードの属性を定義します。読み込み時には、このメンバはハンドヘルドから属性を受け取ります。書き込み時には、このメンバは書き込む属性を指定します。このメンバは 1 つまたは複数の {{goto eSyncRecAttrs,eSyncRecAttrs|C/C++ Sync Suite Reference601/5}} 値の組み合わせです。 *{{span style='color:blue;font-family:monospace;',m_CatId}} **レコードが所属しているカテゴリのインデックス (0 から 15 まで) を定義します。読み込み時には、このメンバはハンドヘルドからカテゴリインデックスを受け取ります。書き込み時には、このメンバはレコードの所属するカテゴリを指定します。 *{{span style='color:blue;font-family:monospace;',m_ConduitId}} **このメンバは使用を推奨されなくなりました。 *{{span style='color:blue;font-family:monospace;',m_RecSize}} **{{span style='color:blue;font-family:monospace;',m_pBytes}} 配列の中の有効なレコードデータまたはリソースデータのバイト数を定義します。読み込み時には、このメンバはレコードまたはリソースの実際のサイズを受け取ります。書き込み時には、このメンバは書き込むデータのサイズを指定します。詳細は以下のコメントを参照してください。 *{{span style='color:blue;font-family:monospace;',m_TotalBytes}} **呼び出し元がレコードデータまたはリソースデータのために割り当てた {{span style='color:blue;font-family:monospace;',m_pBytes}} のサイズを指定します。読み込み時には、このメンバはバッファのサイズを指定します。書き込み時には、このメンバは書き込むレコードまたはリソースのサイズを指定します。詳細は以下のコメントを参照してください。 *{{span style='color:blue;font-family:monospace;',m_pBytes}} **レコードデータまたはリソースデータのためのデータバッファとして使用するバイト配列へのポインタを指定します。読み込み時には、このバッファは要求したデータを受け取ります。書き込み時には、このバッファは書き込むデータを保持します。どちらの場合でも、呼び出し元は同期マネージャ関数を呼び出す前にこのバッファを割り当てなければなりません。 *{{span style='color:blue;font-family:monospace;',m_dwReserved}} **将来使用するために予約されています。呼び出し元は同期マネージャ関数を呼び出す前にこのメンバに {{span style='color:blue;font-family:monospace;',NULL (0)}} をセットしなければなりません。 '''コメント''' 多くの同期マネージャ関数が、ハンドヘルドとクラシックデータベースレコードとリソースを交換するために、{{span style='color:blue;font-family:monospace;',CRawRecordInfo}} クラスのオブジェクトを使用します。各関数は、あなたがその関数を呼び出す前にオブジェクトのある特定のメンバに情報を埋め込むことを要求します; どのメンバに情報を埋め込まなければならないかは各関数のドキュメントで示されています。レコードまたはリソースの読み込み時には、呼び出し元は {{span style='color:blue;font-family:monospace;',m_pTotalBytes}} に {{span style='color:blue;font-family:monospace;',m_pBytes}} によって指されるバッファのサイズを埋め込まなければなりません同期マネージャ関数は {{span style='color:blue;font-family:monospace;',m_RecSize}} にハンドヘルド上のレコードまたはリソースの実際のサイズを埋め込みます - これは、レコードまたはリソースがバッファよりも大きい場合、バッファサイズ {{span style='color:blue;font-family:monospace;',m_TotalBytes}} よりも大きくなる可能性があります。この場合同期マネージャのバージョン 2.1 以降はデータの最初の {{span style='color:blue;font-family:monospace;',m_TotalBytes}} 分だけを呼び出し元のバッファにコピーします; 2.1 よりも前のバージョンは、呼び出し元のバッファに'''何もコピーしません'''。レコードデータまたはリソースデータの書き込み時には、呼び出し元はまず初めに {{span style='color:blue;font-family:monospace;',m_TotalBytes}} と {{span style='color:blue;font-family:monospace;',m_RecSize}} の両方に書き込むデータのサイズをセットしなければなりません。 ::NOTE :::バッファサイズ {{span style='color:blue;font-family:monospace;',m_TotalBytes}} は {{span style='color:blue;font-family:monospace;',UInt16}} 値です。そのため、{{span style='color:blue;font-family:monospace;',CRawRecordInfo}} オブジェクトを使って読み書きできるのは '''64 KB よりも小さな''' レコードとリソースだけです。クラシックデータベースでの最大レコードサイズは 65,505 バイトです。 '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: すべて '''参照''' {{goto SyncDeleteRec,SyncDeleteRec()}}, {{goto SyncDeleteResourceRec,SyncDeleteResourceRec()}}, {{goto SyncReadNextModifiedRec,SyncReadNextModifiedRec()|C/C++ Sync Suite Reference601/4-2}}, {{goto SyncReadNextModifiedRecInCategory,SyncReadNextModifiedRecInCategory()|C/C++ Sync Suite Reference601/4-2}}, {{goto SyncReadNextRecInCategory,SyncReadNextRecInCategory()|C/C++ Sync Suite Reference601/4-2}}, {{goto SyncReadRecordById,SyncReadRecordById()|C/C++ Sync Suite Reference601/4-2}}, {{goto SyncReadRecordByIndex,SyncReadRecordByIndex()|C/C++ Sync Suite Reference601/4-2}}, {{goto SyncReadResRecordByIndex,SyncReadResRecordByIndex()|C/C++ Sync Suite Reference601/4-2}}, {{goto SyncWriteRec,SyncWriteRec()|C/C++ Sync Suite Reference601/4-2}}, {{goto SyncWriteResourceRec,SyncWriteResourceRec()|C/C++ Sync Suite Reference601/4-2}} !!{{anchor Classic Sync Manager Structures and Types}}クラシック同期マネージャ構造体とタイプ {{goto top,^TOP^}} この節では、{{goto Classic Sync Manager Functions,「クラシック同期マネージャ関数」}} で説明されている関数でのみ使用する以下のデータ構造体とタイプについて説明します。クラシック同期マネージャ関数とともに拡張同期マネージャ関数とスキーマ同期マネージャ関数でも使用される構造体とタイプは {{goto Common Sync Manager Structures and Types,「共通同期マネージャ構造体とタイプ」|C/C++ Sync Suite Reference601/5}} で説明されています。 ,構造体とタイプ,説明 ,"{{goto SyncDatabaseInfoType,SyncDatabaseInfoType}}",ハンドヘルド上のデータベースについての情報を取得します。 ,"{{goto SyncFindDbByNameParams,SyncFindDbByNameParams}}","{{span style='color:blue;font-family:monospace;',SyncFindDbByName()}} でデータベースを検索するために使用される情報を指定します。" ,"{{goto SyncFindDbByTypeCreatorParams,SyncFindDbByTypeCreatorParams}}","{{span style='color:blue;font-family:monospace;',SyncFindDbByTypeCreator()}} でデータベースを検索するために使用される情報を指定します。" ,"{{goto SyncReadOpenDbInfoParams,SyncReadOpenDbInfoParams}}","{{span style='color:blue;font-family:monospace;',SyncReadOpenDbInfo()}} でハンドヘルドデータベース情報を取得するための情報を指定します。" !{{anchor SyncDatabaseInfoType}}SyncDatabaseInfoType 構造体 {{goto top,^TOP^}} '''目的''' ハンドヘルド上のデータベースについての情報を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' typedef struct SyncDatabaseInfoType { CDbList baseInfo; UInt32 dwNumRecords; UInt32 dwTotalBytes; UInt32 dwDataBytes; UInt32 dwAppBlkSize; UInt32 dwSortBlkSize; UInt32 dwMaxRecSize; UInt32 dwReserved; UInt32 dwLocalID; UInt32 dwOpenRef; } SyncDatabaseInfoType '''フィールド''' *{{span style='color:blue;font-family:monospace;',baseInfo}} **データベースについての基本的な情報を保持している {{goto CDbList,CDbList|C/C++ Sync Suite Reference601/5}} オブジェクトを受け取ります。 *{{span style='color:blue;font-family:monospace;',dwNumRecords}} **データベースの中にあるレコードまたはリソースの数を受け取ります。このフィールドは {{span style='color:blue;font-family:monospace;',SYNC_DB_INFO_OPT_GET_SIZE}} フラグがセットされている場合にのみ情報を埋め込まれます。 *{{span style='color:blue;font-family:monospace;',dwTotalBytes}} **データベースによって使用されている記憶装置の総バイト数 - オーバヘッドを含む - を受け取ります。このフィールドは {{span style='color:blue;font-family:monospace;',SYNC_DB_INFO_OPT_GET_SIZE}} フラグがセットされている場合にのみ情報を埋め込まれます。 *{{span style='color:blue;font-family:monospace;',dwDataBytes}} **データベースがデータのために使用している記憶装置の総バイト数 - オーバヘッドを除く - を受け取ります。このフィールドは {{span style='color:blue;font-family:monospace;',SYNC_DB_INFO_OPT_GET_SIZE}} フラグがセットされている場合にのみ情報を埋め込まれます。 *{{span style='color:blue;font-family:monospace;',dwAppBlkSize}} **アプリケーション情報ブロックのブロックサイズ - バイト数 - を受け取ります。このフィールドは {{goto SyncReadOpenDbInfo,SyncReadOpenDbInfo()|C/C++ Sync Suite Reference601/4-2}} によってのみ、かつ、{{span style='color:blue;font-family:monospace;',SYNC_DB_INFO_OPT_GET_SIZE}} オプションがセットされている場合にのみ情報を埋め込まれます。 *{{span style='color:blue;font-family:monospace;',dwSortBlkSize}} **ソート情報ブロックのブロックサイズ - バイト数 - を受け取ります。このフィールドは {{goto SyncReadOpenDbInfo,SyncReadOpenDbInfo()|C/C++ Sync Suite Reference601/4-2}} によってのみ、かつ、{{span style='color:blue;font-family:monospace;',SYNC_DB_INFO_OPT_GET_SIZE}} オプションがセットされている場合にのみ情報を埋め込まれます。 *{{span style='color:blue;font-family:monospace;',dwMaxRecSize}} **データベースの中にある最大のレコードまたはリソースのサイズを受け取ります。このフィールドは {{goto SyncReadOpenDbInfo,SyncReadOpenDbInfo()|C/C++ Sync Suite Reference601/4-2}} によってのみ、かつ、{{span style='color:blue;font-family:monospace;',SYNC_DB_INFO_OPT_GET_MAX_REC_SIZE}} オプションがセットされている場合にのみ情報を埋め込まれます。 *{{span style='color:blue;font-family:monospace;',dwReserved}} **将来使用するために予約されています。呼び出し元は同期マネージャ関数を呼び出す前にこのフィールドに {{span style='color:blue;font-family:monospace;',NULL (0)}} をセットしなければなりません。 *{{span style='color:blue;font-family:monospace;',dwLocalID}} *同期マネージャの内部でのみ使用される値を受け取ります。 *{{span style='color:blue;font-family:monospace;',dwOpenRef}} *同期マネージャの内部でのみ使用される値を受け取ります。 '''互換性''' 同期マネージャバージョン: 2.2 以降 *Palm OS バージョン: 3.0 以降 '''参照''' {{goto SyncFindDbByName,SyncFindDbByName()}}, {{goto SyncFindDbByTypeCreator,SyncFindDbByTypeCreator()}}, {{goto SyncReadOpenDbInfo,SyncReadOpenDbInfo()|C/C++ Sync Suite Reference601/4-2}} !{{anchor SyncFindDbByNameParams}}SyncFindDbByNameParams 構造体 {{goto top,^TOP^}} '''目的''' {{goto SyncFindDbByName,SyncFindDbByName()}} でデータベースを検索するために使用される情報を指定します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' typedef struct SyncFindDbByNameParams { HSByte bOptFlags; UInt32 dwCardNum; char *pcDatabaseName; } SyncFindDbByNameParams '''フィールド''' *{{span style='color:blue;font-family:monospace;',bOptFlags}} **検索のためのオプションフラグを指定します。呼び出し元は {{goto Database Information Retrieval Options,「データベース情報取得オプション」|C/C++ Sync Suite Reference601/5}} ({{span style='color:blue;font-family:monospace;',SYNC_DB_INFO_OPT_GET_...}}) からの値を組み合わせることができます。 *{{span style='color:blue;font-family:monospace;',dwCardNum}} **データベースが保存されているカードの番号を指定します。システムの最初のメモリカードはカード番号 0 であり、それに続くカード番号は +1 されていきます。複数の Palm OS メモリカードをサポートするある特定の HandSpring ハンドヘルドを除き、常に 0 を指定します。 *{{span style='color:blue;font-family:monospace;',pcDatabaseName}} **null で終了する文字列へのポイントでデータベース名を指定します。 '''互換性''' 同期マネージャバージョン: 2.2 以降 *Palm OS バージョン: 3.0 以降 '''参照''' {{goto SyncFindDbByName,SyncFindDbByName()}} !{{anchor SyncFindDbByTypeCreatorParams}}SyncFindDbByTypeCreatorParams 構造体 {{goto top,^TOP^}} '''目的''' {{goto SyncFindDbByTypeCreator,SyncFindDbByTypeCreator()}} でデータベースを検索するために使用される情報を指定します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' typedef struct SyncFindDbByTypeCreatorParams { HSByte bOptFlags; HSByte bSrchFlags; UInt32 dwType; UInt32 dwCreator; } SyncFindDbByTypeCreatorParams '''フィールド''' *{{span style='color:blue;font-family:monospace;',bOptFlags}} **検索のためのオプションフラグを指定します。呼び出し元は {{goto Database Information Retrieval Options,「データベース情報取得オプション」|C/C++ Sync Suite Reference601/5}} ({{span style='color:blue;font-family:monospace;',SYNC_DB_INFO_OPT_GET_...}}) からの値を組み合わせることができます。 *{{span style='color:blue;font-family:monospace;',bSrchFlags}} **データベースを検索するための検索オプションを指定します。呼び出し元は {{goto Database Search Options,「データベース検索オプション」|C/C++ Sync Suite Reference601/5}} ({{span style='color:blue;font-family:monospace;',SYNC_DB_INFO_OPT_...}}) からの値を組み合わせることができます。 *{{span style='color:blue;font-family:monospace;',dwType}} **4 バイトのタイプ識別しでデータベースタイプを指定します。呼び出し元はすべてのデータベースタイプを検索するために値 0 を指定してワイルドカード検索を行うことができます。 *{{span style='color:blue;font-family:monospace;',dwCreator}} **検索するデータベースの作成者 ID を指定します。すべての作成者 ID に対して検索を行うには値 0 を指定します。 '''互換性''' 同期マネージャバージョン: 2.2 以降 *Palm OS バージョン: 3.0 以降 '''参照''' {{goto SyncFindDbByTypeCreator,SyncFindDbByTypeCreator()}} !{{anchor SyncReadOpenDbInfoParams}}SyncReadOpenDbInfoParams 構造体 {{goto top,^TOP^}} '''目的''' {{goto SyncReadOpenDbInfo,SyncReadOpenDbInfo()|C/C++ Sync Suite Reference601/4-2}} でハンドヘルドデータベース情報を取得するための情報を指定します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' typedef struct SyncReadOpenDbInfoParams { HSByte bOptFlags; HSByte bDbHandle; } SyncReadOpenDbInfoParams '''フィールド''' *{{span style='color:blue;font-family:monospace;',HSByte}} **検索のためのオプションフラグを指定します。呼び出し元は {{goto Database Information Retrieval Options,「データベース情報取得オプション」|C/C++ Sync Suite Reference601/5}} ({{span style='color:blue;font-family:monospace;',SYNC_DB_INFO_OPT_GET_...}}) からの値を組み合わせることができます。 *{{span style='color:blue;font-family:monospace;',HSByte}} {{goto SyncOpenDB,SyncOpenDB()}} または {{goto SyncCreateDB,SyncCreateDB()}} 呼び出しから返されるオープンされたデータベースへのハンドルを指定します。 '''互換性''' 同期マネージャバージョン: 2.2 以降 *Palm OS バージョン: 3.0 以降 '''参照''' {{goto SyncFindDbByTypeCreator,SyncFindDbByTypeCreator()}} !!{{anchor Classic Sync Manager Constants}}クラシック同期マネージャ定数 {{goto top,^TOP^}} この節では、{{goto Classic Sync Manager Functions,「クラシック同期マネージャ関数」}} で説明されている関数でのみ使用する以下のプロセッサ定数について説明します。クラシック同期マネージャ関数とともに拡張同期マネージャ関数とスキーマ同期マネージャ関数でも使用される定数は {{goto Common Sync Manager Constants,「共通同期マネージャ定数」|C/C++ Sync Suite Reference601/5}} で説明されています。 ,定数,説明 ,"{{goto Deprecated Constatns,使用を推奨されなくなった定数}}","{{goto CRawRecordInfo,CRawRecordInfo}}.{{span style='color:blue;font-family:monospace;',m_Attribs}} で使用される新しい定数の使用を推奨されなくなったバージョン。この定数の代わりに {{goto eSyncRecAttrs,eSyncRecAttrs|C/C++ Sync Suite Reference601/5}} 列挙体によって定義されている値を使用します。" !{{anchor Deprecated Constants}}使用を推奨されなくなった定数 {{goto top,^TOP^}} '''目的''' {{goto CRawRecordInfo,CRawRecordInfo}}.{{span style='color:blue;font-family:monospace;',m_Attribs}} で使用される新しい定数の使用を推奨されなくなったバージョン。以下で示すようにこの定数の代わりに {{goto eSyncRecAttrs,eSyncRecAttrs|C/C++ Sync Suite Reference601/5}} 列挙体によって定義されている値を使用します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''定数''' #define ARCHIVE_BIT eRecAttrArchived #define DELETE_BIT eRecAttrDeleted #define DIRTY_BIT eRecAttrDirty #define PRIVATE_BIT eRecAttrSecret '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: すべて '''参照''' {{goto eSyncRecAttrs,eSyncRecAttrs|C/C++ Sync Suite Reference601/5}}, {{goto CRawRecordInfo,CRawRecordInfo}} !!{{anchor Classic Sync Manager Functions}}クラシック同期マネージャ関数 {{goto top,^TOP^}} この節では、クラシックデータベースにのみアクセスする以下の関数について説明します。すべてのタイプのデータベースにアクセスする関数やデータベースにアクセスしないユーティリティ関数やマクロについては {{goto Common Sync Manager Functions and Maros,「共通同期マネージャ関数とマクロ」|C/C++ Sync Suite Reference601/5}} を参照してください。 ,関数,説明 ,"{{goto SyncCallRemoteModule,SyncCallRemoteModule()}}","ハンドヘルド上のモジュール（アプリケーション、パネル、他の実行可能なもの）を呼び出し、そのモジュールからあなたのコンジットにデータとステータス情報を返します。" ,"{{goto SyncChangeCategory,SyncChangeCategory()}}","クラシックデータベースの中であるカテゴリ（ソースカテゴリ）からすべてのレコードを他のカテゴリ（ターゲットカテゴリ）に移動させます。" ,"{{goto SyncCloseDB,SyncCloseDB()}}","{{span style='color:blue;font-family:monospace;',SyncOpenDB()}} または {{span style='color:blue;font-family:monospace;',SyncCreateDB()}} によってオープンされていたクラシックデータベースをクローズします。" ,"{{goto SyncCloseDBEx,SyncCloseDBEx()}}","{{span style='color:blue;font-family:monospace;',SyncOpenDB()}} または {{span style='color:blue;font-family:monospace;',SyncCreateDB()}} によってオープンされていたクラシックデータベースをクローズし、オプションとしてそのデータベースのバックアップ日付と変更日付を更新します。" ,"{{goto SyncCreateDB,SyncCreateDB()}}","新しいクラシックデータベースをハンドヘルド上に作成し、そのデータベースをオープンし、そのデータベースへのハンドルを返します。" ,"{{goto SyncDeleteAllResourceRec,SyncDeleteAllResourceRec()}}","クラシックデータベースからすべてのリソースを削除し、それらのデータを処分します。" ,"{{goto SyncDeleteDB,SyncDeleteDB()}}","ハンドヘルド上のクラシックデータベースを削除します。" ,"{{goto SyncDeleteRec,SyncDeleteRec()}}","クラシックデータベースからすべてのレコードを削除し、それらのデータを処分します。" ,"{{goto SyncDeleteResourceRec,SyncDeleteResourceRec()}}","クラシックデータベースからあるリソースを削除し、それのデータを処分します。" ,"{{goto SyncFindDbByName,SyncFindDbByName()}}","名前とメモリカード番号でハンドヘルド上のクラシックデータベースを探し、見つかった場合はそのデータベースについての情報を返します。" ,"{{goto SyncFindDbByTypeCreator,SyncFindDbByTypeCreator()}}","タイプと作成者 ID でハンドヘルド上のデータベースを探し、見つかった場合はそのデータベースについての情報を返します。" ,"{{goto SyncGetDBRecordCount,SyncGetDBRecordCount()}}","ハンドヘルド上のあるクラシックデータベースの総レコード数または総リソース数を取得します。" ,"{{goto SyncMaxRemoteRecSize,SyncMaxRemoteRecSize()}}","ハンドヘルド上のクラシックデータベースでサポートされるレコードまたはリソースの最大サイズを取得します。" ,"{{goto SyncOpenDB,SyncOpenDB()}}","ハンドヘルド上の既存のクラシックデータベースをオープンします。" ,"{{goto SyncPurgeAllRecs,SyncPurgeAllRecs()}}","レコードステータスに関係なくあるクラシックデータベースからすべてのレコードを削除し、それらのデータを処分します。" ,"{{goto SyncPurgeAllRecsInCategory,SyncPurgeAllRecsInCategory()}}","レコードステータスに関係なくあるクラシックデータベースからある特定のカテゴリに属するすべてのレコードを削除し、それらのデータを処分します。" ,"{{goto SyncPurgeDeletedRecs,SyncPurgeDeletedRecs()}}","あるクラシックデータベースから「削除された」または「アーカイブされた」というマークを付けられているすべてのレコードを削除し、それらのデータを処分します。" ,"{{goto SyncReadAppPreference,SyncReadAppPreference()|C/C++ Sync Suite Reference601/4-2}}","ハンドヘルド上のアプリケーションデータベースの 1 つからアプリケーションの設定ブロックを取得します。" ,"{{goto SyncReadDBAppInfoBlock,SyncReadDBAppInfoBlock()|C/C++ Sync Suite Reference601/4-2}}","ハンドヘルド上のクラシックデータベースからアプリケーション情報ブロック - それが存在する場合は - を取得します。" ,"{{goto SyncReadDBList,SyncReadDBList()|C/C++ Sync Suite Reference601/4-2}}","ハンドヘルド上のクラシックデータベースのリストについての情報を取得します。" ,"{{goto SyncReadDBSortInfoBlock,SyncReadDBSortInfoBlock()|C/C++ Sync Suite Reference601/4-2}}","ハンドヘルド上のクラシックデータベースからソート情報ブロック - それが存在する場合は - を取得します。" ,"{{goto SyncReadNextModifiedRec,SyncReadNextModifiedRec()|C/C++ Sync Suite Reference601/4-2}}","ハンドヘルド上のクラシックレコードデータベースから次の変更された、アーカイブされた、削除されたレコードを取得します。この反復関数の各呼び出しはすべての変更されたレコードが返されるまで次の変更されたレコードを取得します。" ,"{{goto SyncReadNextModifiedRecInCategory,SyncReadNextModifiedRecInCategory()|C/C++ Sync Suite Reference601/4-2}}","ハンドヘルド上のクラシックデータベースからあるカテゴリの中にある次の変更されたレコード - 削除されたレコードやアーカイブされたレコードを含む - を取得します。この反復関数の各呼び出しはすべての変更されたレコードが取得されるまであるカテゴリの中にある次の変更されたレコードを取得します。" ,"{{goto SyncReadNextRecInCategory,SyncReadNextRecInCategory()|C/C++ Sync Suite Reference601/4-2}}","ハンドヘルド上のクラシックレコードデータベースからあるカテゴリの中にあるすべてのレコード - 削除、アーカイブ、変更されたレコードを含む - を取得します。この反復関数の各呼び出しはすべてのレコードが取得されるまであるカテゴリの中にある次のレコードを取得します。" ,"{{goto SyncReadOpenDbInfo,SyncReadOpenDbInfo()|C/C++ Sync Suite Reference601/4-2}}","ハンドヘルド上のクラシックデータベースについての包括的な情報を取得します。" ,"{{goto SyncReadPositionXMap,SyncReadPositionXMap()|C/C++ Sync Suite Reference601/4-2}}","ハンドヘルド上のクラシックデータベースからソートされた順番になっているレコード ID のリストを取得します。" ,"{{goto SyncReadRecordById,SyncReadRecordById()|C/C++ Sync Suite Reference601/4-2}}","ハンドヘルド上のクラシックレコードデータベースから固有レコード ID でレコードを取得します。" ,"{{goto SyncReadRecordByIndex,SyncReadRecordByIndex()|C/C++ Sync Suite Reference601/4-2}}","ハンドヘルド上のクラシックレコードデータベースからインデックスでレコードを取得します。" ,"{{goto SyncReadResRecordByIndex,SyncReadResRecordByIndex()|C/C++ Sync Suite Reference601/4-2}}","ハンドヘルド上のオープンされているリソースデータベースからインデックスでリソースレコードを取得します。" ,"{{goto SyncResetRecordIndex,SyncResetRecordIndex()|C/C++ Sync Suite Reference601/4-2}}","ハンドヘルド上のオープンされているクラシックレコードデータベースのレコード反復インデックスをリセットします。" ,"{{goto SyncResetSyncFlags,SyncResetSyncFlags()|C/C++ Sync Suite Reference601/4-2}}","ハンドヘルド上のオープンされているクラシックレコードデータベースの中にあるすべてのレコードの変更フラグをリセットします。オープンされているレコードデータベースまたはリソースデータベースのバックアップ日付をリセットします。" ,"{{goto SyncWriteAppPreference,SyncWriteAppPreference()|C/C++ Sync Suite Reference601/4-2}}","アプリケーション設定をハンドヘルド上の設定データベースに書き込みます。" ,"{{goto SyncWriteDBAppInfoBlock,SyncWriteDBAppInfoBlock()|C/C++ Sync Suite Reference601/4-2}}","アプリケーション情報ブロックをハンドヘルド上のクラシックレコードデータベースまたはクラシックリソースデータベースに書き込みます。" ,"{{goto SyncWriteDBSortInfoBlock,SyncWriteDBSortInfoBlock()|C/C++ Sync Suite Reference601/4-2}}","ソート情報ブロックをクラシックレコードデータベースまたはクラシックリソースデータベースに書き込みます。" ,"{{goto SyncWriteRec,SyncWriteRec()|C/C++ Sync Suite Reference601/4-2}}","レコードをハンドヘルド上のクラシックレコードデータベースに書き込みます。" ,"{{goto SyncWriteResourceRec,SyncWriteResourceRec()|C/C++ Sync Suite Reference601/4-2}}","リソースをハンドヘルド上のクラシックリソースデータベースに書き込みます。" !{{anchor SyncCallRemoteModule}}SyncCallRemoteModule 関数 {{goto top,^TOP^}} '''目的''' ハンドヘルド上のモジュール（アプリケーション、パネル、その他の実行可能なもの）を呼び出し、そのモジュールからあなたのコンジットにデータとステータス情報を返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' SInt32 SyncCallRemoteModule ( CCallModuleParams *pParams ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',←→ pParams}} **呼び出されるモジュールの情報を指定し、呼び出されるモジュールから情報を受け取る {{goto CCallModuleParams,CCallModuleParams}} クラスのオブジェクト。デスクトップからハンドヘルドアプリケーション渡される引数のサイズには 64 KB という制限があるということに注意してください。 '''返り値''' 成功時には 0 を返します。不成功時には、以下の非 0 エラーコード値の 1 つを返します。 *{{span style='color:blue;font-family:monospace;',SYNCERR_COMM_NOT_INIT}} *{{span style='color:blue;font-family:monospace;',SYNCERR_LOST_CONNECTION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_SYS}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_MEM}} *{{span style='color:blue;font-family:monospace;',SYNCERR_UNKNOWN_REQUEST}} **ハンドヘルド上にモジュールが見つからなかった、または、ハンドヘルド上のモジュールはアクションコードをハンドルしなかった。 *{{span style='color:blue;font-family:monospace;',SYNCERR_LOCAL_BUFF_TOO_SMALL}}**結果を受け取るバッファが結果のデータを受け取るのに十分なほど大きくなかった。このケースでは、返り時に {{span style='color:blue;font-family:monospace;',dwActResultSize}} の値は {{span style='color:blue;font-family:monospace;',dwResultBufSize}} よりも大きくなり、{{span style='color:blue;font-family:monospace;',dwResultBufSize}} バイト分だけが結果を受け取るバッファにコピーされます。すべての同期マネージャエラーコードの記述は {{goto Common Sync Manager Error Codes,「共通同期マネージャエラーコード」|C/C++ Sync Suite Reference601/5}} を参照してください。 '''コメント''' ::重要 :::この関数はクラシックデータベース - これには {{goto 64K application,64K アプリケーション|Introduction to Conduit Development601/Glossary}} が保存されます - に対してのみ機能します。これは Palm OS Cobalt と Palm OS Garnet の両方で、またそれよりも前のハンドヘルドで機能します。Palm OS Cobalt ハンドヘルドで {{goto Palm OS Protein application,Palm OS Protein アプリケーション|Introduction to Conduit Development601/Glossay}} を呼び出すには、代わりに {{goto SyncCallDeviceApplication,SyncCallDeviceApplication()}} を使用しなければなりません。たいてのコンジットはこの関数を使用せずに仕事を達成することができます。PalmSource は絶対必要でない限りこの関数は使用しないように勧めています。この関数は、呼び出し元が {{span style='color:blue;font-family:monospace;',pParams}} パラメータの中の任意のデータを HotSync 中にハンドヘルド上のモジュールに送ることを可能にします。モジュールは {{span style='color:blue;font-family:monospace;',pParams}} の中に可変サイズの情報を戻すことができ、この関数の返り時に呼び出し元はそれを検証することができます。データとアクションコードのフォーマットは完全にモジュール特有であるということに注意してください。あなたが呼び出すハンドヘルドモジュールは Palm OS アプリケーションと同じ構造を持たなければなりません; しかしながら、そのモジュールはランチャには表示されないように所有者（訳者注: 作成者）のタイプ ID を持つことができます。あなたがコンジットから {{span style='color:blue;font-family:monospace;',SyncCallRemoteModule()}} を呼び出すとき、ハンドヘルド上のそのモジュールは {{span style='color:blue;font-family:monospace;',sysAppLaunchCmdHandleSyncCallApp}} 起動コードで起動します。この起動コードをハンドルするために、そのハンドヘルドモジュールは {{span style='color:blue;font-family:monospace;',PilotMain()}} に渡されるコマンドパラメータブロックを {{span style='color:blue;font-family:monospace;',SysAppLaunchCmdHandleSyncCallAppType}} ポインタにキャストしなければなりません。{{span style='color:blue;font-family:monospace;',SysAppLaunchCmdHandleSyncCallAppType}} 構造体はデスクトップに返される結果に渡す必要があるフィールドとともに呼び出し元がデスクトップ上の {{span style='color:blue;font-family:monospace;',SyncCallRemoteModule()}} に渡したすべての情報を保持します。ハンドヘルドモジュールは、{{span style='color:blue;font-family:monospace;',sysAppLaunchCmdHandleSyncCallApp}} 起動コードを処理した後、DLServer ({{span style='color:blue;font-family:monospace;',DLServer.h}}) の {{span style='color:blue;font-family:monospace;',DlkControl()}} 関数を使って {{span style='color:blue;font-family:monospace;',DlkCallAppReplyParamType}} 応答をデスクトップに送り返さなければなりません。 {{goto Table 4.1,表 4.1}} と {{goto Table 4.2,表 4.2}} はデスクトップ上の同期マネージャの {{goto CCallModuleParams,CCallModuleParams}} クラスからハンドヘルド上の {{span style='color:blue;font-family:monospace;',SysAppLaunchCmdHandleSyncCallAppType}} と {{span style='color:blue;font-family:monospace;',DlkCallAppReplyParamType}} 構造体へのいくつかの重要なマッピングです。 {{anchor Table 4.1}} '''表 4.1 デスクトップ同期マネージャ CCallModuleParams からハンドヘルド SysAppLaunchCmdHandleSyncCallAppType へのマッピング''' ,"{{span style='color:blue;font-family:monospace;',CCallModuleParams}}","{{span style='color:blue;font-family:monospace;',SysAppLaunchCmdHandleSyncCallAppType}} 構造体" ,"{{span style='color:blue;font-family:monospace;',m_wActionCode}}","{{span style='color:blue;font-family:monospace;',action}}" ,"{{span style='color:blue;font-family:monospace;',m_dwParamSize}}","{{span style='color:blue;font-family:monospace;',dwParamSize}}" ,"{{span style='color:blue;font-family:monospace;',m_pParam}}","{{span style='color:blue;font-family:monospace;',paramP}}" {{anchor Table 4.2}} '''表 4.2 デスクトップ同期マネージャ CCallModuleParams からハンドヘルド DlkCallAppReplyPramType へのマッピング''' ,"{{span style='color:blue;font-family:monospace;',CCallModuleParams}}","{{span style='color:blue;font-family:monospace;',SysAppLaunchCmdHandleSyncCallAppType}} 構造体" ,"{{span style='color:blue;font-family:monospace;',m_dwResultBufSize}}","{{span style='color:blue;font-family:monospace;',dwResultSize}}" ,"{{span style='color:blue;font-family:monospace;',m_pResultBuf}}","{{span style='color:blue;font-family:monospace;',resultP}}" ,"{{span style='color:blue;font-family:monospace;',m_dwResultCode}}","{{span style='color:blue;font-family:monospace;',dwResultCode}}" 更なる情報とハンドヘルドアプリケーションコードの例は、''Exploring Palm OS: System Management'' を参照してください。 {{anchor For Palm OS Cobalt Handhelds}} '''Palm OS Cobalt ハンドヘルドのために''' {{span style='color:blue;font-family:monospace;',pParams->m_dwTypeID}} が 0 の場合、{{goto SyncCallRemoteModule,SyncCallRemoteModule()}} はタイプ {{span style='color:blue;font-family:monospace;',sysFileTApplication}} を持つ {{span style='color:blue;font-family:monospace;',DmFindDatabaseByTypeCreator(dmFindClassicDB)}} によって返される最初のアプリケーションを起動します; さもなければ、そのようなアプリケーションが存在しない場合、タイプ {{span style='color:blue;font-family:monospace;',sysFileTPanel}} を持つ {{span style='color:blue;font-family:monospace;',DmFindDatabaseByTypeCreator(dmFindClassicDB)}} によって返される最初のアプリケーションを起動します; さもなければエラーを返します。そのため {{span style='color:blue;font-family:monospace;',SyncCallRemoteModule()}} は実際は 0 のセッティング {{span style='color:blue;font-family:monospace;',m_dwTypeID}} を {{span style='color:blue;font-family:monospace;',sysFileTApplication}} のタイプ ID を持つ最初の呼び出しに対するサブタイトルとして扱い、それから{{span style='color:blue;font-family:monospace;',sysFileTPanel}} のタイプ ID として扱います。上で注意書きされているように、この関数はクラシックデータベースだけを呼び出します; Palm OS Cobalt ハンドヘルド上の {{goto Palm OS Protein application,Palm OS Protein アプリケーション|Introduction to Conduit Development601/Glossary}} を呼び出すために使用することはできません。 '''互換性''' 同期マネージャバージョン: 2.1 以降 *Palm OS バージョン: Palm OS 2.0 以降。「コメント」を参照してください。 Palm OS Cobalt を実行しているハンドヘルドでは、ここから '''参照''' {{goto CCallModuleParams,CCallModuleParams}}, {{goto SyncCallDeviceApplication,SyncCallDeviceApplication()|C/C++ Sync Suite Reference601/5}} !{{anchor SyncChangeCategory}}SyncChangeCategory 関数 {{goto top,^TOP^}} '''目的''' クラシックデータベースの中にあるすべてのレコードをあるカテゴリ（ソースカテゴリ）から他のカテゴリ（ターゲットカテゴリ）に移動させます。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' SInt32 SyncChangeCategory ( HSByte fHandle, HSByte from, HSByte to ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ fHandle}} **ハンドヘルド上のクラシックデータベースへのハンドル。このハンドルは {{goto SyncOpenDB,SyncOpenDB()}} または {{goto SyncCreateDB,SyncCreateDB()}} 呼び出しによって返されます。データベースは読み込み、書き込みのためにオープンされていなければなりません。 *{{span style='color:blue;font-family:monospace;',→ from}} **ソースカテゴリのインデックス。これは 0 から 15 までの値でなければなりません。 *{{span style='color:blue;font-family:monospace;',→ to}} **ターゲットカテゴリのインデックス。これは 0 から 15 までの値でなければなりません。 '''返り値''' 成功時には {{span style='color:blue;font-family:monospace;',SYNCERR_NONE}} を返します。不成功時には以下のエラーコード値の 1 つを返します。 *{{span style='color:blue;font-family:monospace;',SYNCERR_COMM_NOT_INIT}} *{{span style='color:blue;font-family:monospace;',SYNCERR_LOST_CONNECTION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_BAD_ARG}} *{{span style='color:blue;font-family:monospace;',SYNCERR_NO_FILES_OPEN}} *{{span style='color:blue;font-family:monospace;',SYNCERR_BAD_OPERATION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_READ_ONLY}} すべての同期マネージャエラーコードの記述は {{goto Common Sync Manager Error Codes,「共通同期マネージャエラーコード」|C/C++ Sync Suite Reference601/5}} を参照してください。 '''コメント''' この関数はハンドヘルド上のオープンされているデータベースの中の指定されたカテゴリに所属するすべてのレコードのカテゴリインデックスを変更します。しかし、これはレコードの変更ステータスを変更することはしません。 {{span style='color:blue;font-family:monospace;',from}} と {{span style='color:blue;font-family:monospace;',to}} で指定されるカテゴリインデックス値は 0 から 15 の範囲内でなければなりません。慣例ではインデックス 0 は未分類カテゴリであり、1 から 15 までのインデックス値は分類されたカテゴリのインデックス値です。 '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: すべて !{{anchor SyncCloseDB}}SyncCloseDB 関数 {{goto top,^TOP^}} '''目的''' {{goto SyncOpenDB,SyncOpenDB()}} または {{goto SyncCreateDB,SyncCreateDB()}} でオープンされたクラシックデータベースをクローズします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' SInt32 SyncCloseDB ( HSByte fHandle ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ fHandle}} **ハンドヘルド上のクラシックデータベースへのハンドル。このハンドルはデータベースをオープンした {{goto SyncOpenDB,SyncOpenDB()}} または {{goto SyncCreateDB,SyncCreateDB()}} 呼び出しによって返されます。 '''返り値''' 成功時には {{span style='color:blue;font-family:monospace;',SYNCERR_NONE}} を返します。これはデータベースはクローズされ、それのハンドルは破棄されたことを意味します。不成功時には以下のエラーコード値の 1 つを返します。 *{{span style='color:blue;font-family:monospace;',SYNCERR_COMM_NOT_INIT}} *{{span style='color:blue;font-family:monospace;',SYNCERR_LOST_CONNECTION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_SYS}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_MEM}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_BAD_ARG}} *{{span style='color:blue;font-family:monospace;',SYNCERR_NO_FILES_OPEN}} すべての同期マネージャエラーコードの記述は {{goto Common Sync Manager Error Codes,「共通同期マネージャエラーコード」|C/C++ Sync Suite Reference601/5}} を参照してください。 '''コメント''' 同期マネージャは常にクラシックデータベースを 1 つだけオープンさせておくことを許可します; それゆえ、あなたは他のクラシックデータベースをオープンさせる、あるいは、あなたのコンジットを終了させる前にこの関数か {{goto SyncCloseDBEx,SyncCloseDBEx()}} を使用しなければなりません。さもなければ、他のコンジットはクラシックデータベースをオープンすることができなくなります。 '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: すべて '''参照''' {{goto SyncCreateDB,SyncCreateDB()}}, {{goto SyncOpenDB,SyncOpenDB()}}, {{goto SyncCloseDBEx,SyncCloseDBEx()}} !{{anchor SyncCloseDBEx}}SyncCloseDBEx 関数 {{goto top,^TOP^}} '''目的''' 以前に {{goto SyncOpenDB,SyncOpenDB()}} または {{goto SyncCreateDB,SyncCreateDB()}} によってオープンされたクラシックデータベースをクローズして、オプションとしてバックアップ日付と変更日付を更新します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' SInt32 SyncCloseDBEx ( HSByte dbHandle, HSByte bOptFlags ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ dbHandle}} **ハンドヘルド上のクラシックデータベースへのハンドル。このハンドルはデータベースをオープンした {{goto SyncOpenDB,SyncOpenDB()}} または {{goto SyncCreateDB,SyncCreateDB()}} 呼び出しによって返されます。 *{{span style='color:blue;font-family:monospace;',→ bOptFlags}} データベースの日付を更新するためのオプション。あなたは {{goto Database Closing Options,「データベースクローズオプション」|C/C++ Sync Suite Reference601/5}} で定義されている定数を組み合わせることができます。 '''返り値''' 成功時には {{span style='color:blue;font-family:monospace;',SYNCERR_NONE}} を返します。これはデータベースはクローズされ、それのハンドルは破棄されたことを意味します。不成功時には以下のエラーコード値の 1 つを返します。 *{{span style='color:blue;font-family:monospace;',SYNCERR_COMM_NOT_INIT}} *{{span style='color:blue;font-family:monospace;',SYNCERR_LOST_CONNECTION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_SYS}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_MEM}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_BAD_ARG}} *{{span style='color:blue;font-family:monospace;',SYNCERR_NO_FILES_OPEN}} すべての同期マネージャエラーコードの記述は {{goto Common Sync Manager Error Codes,「共通同期マネージャエラーコード」|C/C++ Sync Suite Reference601/5}} を参照してください。 '''コメント''' この関数は {{goto SyncCloseDB,SyncCloseDB()}} 関数の拡張バージョンです。{{span style='color:blue;font-family:monospace;',SyncCloseDBEx()}} は追加のオプションフラグパラメータ ({{span style='color:blue;font-family:monospace;',bOptFlags}}) を取り、データベースをクローズするときにそのデータベースの変更日付とバックアップ日付を更新することができます。ハンドヘルドが Palm OS のバージョン 3.0 よりも前のものを使用している場合、あなたは {{span style='color:blue;font-family:monospace;',bOptFlags}} 引数に 0 の値を指定しなければなりません; さもないと、この関数は失敗します。同期マネージャは常にクラシックデータベースを 1 つだけオープンさせておくことを許可します; それゆえ、あなたは他のクラシックデータベースをオープンさせる、あるいは、あなたのコンジットを終了させる前にこの関数か {{goto SyncCloseDB,SyncCloseDB()}} を使用しなければなりません。さもなければ、他のコンジットはクラシックデータベースをオープンすることができなくなります。 '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: すべて* ＊Palm OS のバージョン 3.0 よりも前では、{{span style='color:blue;font-family:monospace;',bOptFlags}} は 0 を指定されなければなりません。値が 0 のとき、{{span style='color:blue;font-family:monospace;',SyncCloseDBEx}} は {{span style='color:blue;font-family:monospace;',SyncCloseDB}} と同じように動作します。 '''参照''' {{goto SyncCreateDB,SyncCreateDB()}}, {{goto SyncOpenDB,SyncOpenDB()}}, {{goto SyncCloseDB,SyncCloseDB()}} !{{anchor SyncCreateDB}}SyncCreateDB 関数 {{goto top,^TOP^}} '''目的''' ハンドヘルド上に新しいクラシックデータベースを作成し、そのデータベースをオープンし、そのデータベースへのハンドルを返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' SInt32 SyncCreateDB ( CDbCreateDB &rDbStats ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',←→ rDbStats}} **{{goto CDbCreateDB,CDbCreateDB}} クラスのオブジェクトの中で指定されるデータベース作成情報。このパラメータの {{span style='color:blue;font-family:monospace;',m_FileHandle}} データメンバはオープンされたデータベースへのハンドルを受け取ります。 '''返り値''' 成功時には {{span style='color:blue;font-family:monospace;',SYNCERR_NONE}} を返します。これはデータベースは作成され、それのハンドルが {{span style='color:blue;font-family:monospace;',rDbStats}} の {{span style='color:blue;font-family:monospace;',m_FileHandle}} データメンバに保存されたことを意味します。不成功時には以下のエラーコード値の 1 つを返します。 *{{span style='color:blue;font-family:monospace;',SYNCERR_COMM_NOT_INIT}} *{{span style='color:blue;font-family:monospace;',SYNCERR_LOST_CONNECTION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_SYS}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_MEM}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_BAD_ARG}} *{{span style='color:blue;font-family:monospace;',SYNCERR_FILE_ALREADY_EXIST}} *{{span style='color:blue;font-family:monospace;',SYNCERR_TOO_MANY_OPEN_FILES}} *{{span style='color:blue;font-family:monospace;',SYNCERR_FILE_NOT_OPEN}} すべての同期マネージャエラーコードの記述は {{goto Common Sync Manager Error Codes,「共通同期マネージャエラーコード」|C/C++ Sync Suite Reference601/5}} を参照してください。 '''コメント''' この関数はデータベースを作成した後、そのデータベースを排他的読み込み、書き込みアクセスで、プライベート（シークレット）レコードを表示でオープンします。 {{span style='color:blue;font-family:monospace;',SyncCreateDB()}} は既存のデータベースを上書きすることはできません。あなたが既存のデータベースの名前でデータベースを作成しようとした場合、{{span style='color:blue;font-family:monospace;',SyncCreateDB}} は {{span style='color:blue;font-family:monospace;',SYNCERR_FILE_ALREADY_EXIST}} エラーで失敗します。既存のデータベースを置き換えるには、あらかじめ古いデータベースを {{goto SyncDeleteDB,SyncDeleteDB()}} で削除し、それから新しいデータベースを作成するために {{span style='color:blue;font-family:monospace;',SyncCreateDB()}} を呼び出します。同期マネージャは常にクラシックデータベースを 1 つだけオープンさせておくことを許可します; それゆえ、あなたはこの関数を呼び出す前にオープンされているクラシックデータベースをクローズしなければなりません。さもなければ、他のコンジットはクラシックデータベースをオープンすることができなくなります。 '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: すべて '''参照''' {{goto CDbCreateDB,CDbCreateDB}}, {{goto SyncDeleteDB,SyncDeleteDB()}}, {{goto SyncCloseDB,SyncCloseDB()}}, {{goto SyncCloseDBEx,SyncCloseDBEx()}} !{{anchor SyncDeleteAllResourceRec}}SyncDeleteAllResourceRec 関数 {{goto top,^TOP^}} '''目的''' クラシックデータベースからすべてのリソースを削除し、それらのデータを処分します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' SInt32 SyncDeleteAllResourceRec ( HSByte fHandle ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ fHandle}} **ハンドヘルド上のクラシックデータベースへのハンドル。このハンドルは {{goto SyncOpenDB,SyncOpenDB()}} または {{goto SyncCreateDB,SyncCreateDB()}} 呼び出しによって返されます。 '''返り値''' 成功時には {{span style='color:blue;font-family:monospace;',SYNCERR_NONE}} を返します。不成功時には以下のエラーコード値の 1 つを返します。 *{{span style='color:blue;font-family:monospace;',SYNCERR_COMM_NOT_INIT}} *{{span style='color:blue;font-family:monospace;',SYNCERR_LOST_CONNECTION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_SYS}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_BAD_ARG}} *{{span style='color:blue;font-family:monospace;',SYNCERR_NO_FILES_OPEN}} *{{span style='color:blue;font-family:monospace;',SYNCERR_BAD_OPERATION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_READ_ONLY}} すべての同期マネージャエラーコードの記述は {{goto Common Sync Manager Error Codes,「共通同期マネージャエラーコード」|C/C++ Sync Suite Reference601/5}} を参照してください。 '''コメント''' この関数を呼び出す前に、データベースは読み込み、書き込み可能な状態でオープンされていなければなりません。この関数はただちにリソースのデータチャンクを処分し、リソースのエントリをデータベースヘッダから削除します。 '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: すべて '''参照''' {{goto SyncOpenDB,SyncOpenDB()}}, {{goto SyncCreateDB,SyncCreateDB()}} !{{anchor SyncDeleteDB}}SyncDeleteDB 関数 {{goto top,^TOP^}} '''目的''' ハンドヘルド上のクラシックデータベースを削除します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' SInt32 SyncDeleteDB ( const char *pName, SInt32 nCardNum ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pName}} **ハンドヘルド上のデータベースの名前。これは null で終了する文字の配列です。 *{{span style='color:blue;font-family:monospace;',→ nCardNum}} **ハンドヘルド上でデータベースが存在しているメモリカードの番号。システムの最初のメモリカードはカード番号 0 であり、その後に続くカード番号は +1 されていきます。複数の Palm OS メモリカードをサポートするある特定の HandSpring ハンドヘルドを除き、常に 0 を指定します。 '''返り値''' 成功時には {{span style='color:blue;font-family:monospace;',SYNCERR_NONE}} を返します。これはデータベースが削除されたことを意味します。不成功時には以下のエラーコード値の 1 つを返します。 *{{span style='color:blue;font-family:monospace;',SYNCERR_COMM_NOT_INIT}} *{{span style='color:blue;font-family:monospace;',SYNCERR_LOST_CONNECTION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_SYS}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_MEM}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_BAD_ARG}} *{{span style='color:blue;font-family:monospace;',SYNCERR_NOT_FOUND}} *{{span style='color:blue;font-family:monospace;',SYNCERR_FILE_NOT_OPEN}} *{{span style='color:blue;font-family:monospace;',SYNCERR_FILE_ALREADY_OPEN}} すべての同期マネージャエラーコードの記述は {{goto Common Sync Manager Error Codes,「共通同期マネージャエラーコード」|C/C++ Sync Suite Reference601/5}} を参照してください。 '''コメント''' あなたはオープンされているデータベースを削除することはできません; あなたはまずデータベースをクローズしなければなりません。 '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: すべて '''参照''' {{goto SyncCloseDB,SyncCloseDB()}}, {{goto SyncCloseDBEx,SyncCloseDBEx()}}, {{goto SyncCreateDB,SyncCreateDB()}} !{{anchor SyncDeleteRec}}SyncDeleteRec 関数 {{goto top,^TOP^}} '''目的''' クラシックデータベースからレコードを削除し、それのデータを処分します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' SInt32 SyncDeleteRec ( CRawRecordInfo &rInfo ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ rInfo}} **レコードとデータベースについての情報を指定する {{goto CRawRecordInfo,CRawRecordInfo}} クラスのオブジェクト。呼び出し元は {{span style='color:blue;font-family:monospace;',m_FileHandle}} メンバと {{span style='color:blue;font-family:monospace;',m_RecId}} メンバを指定しなければなりません。 '''返り値''' 成功時には {{span style='color:blue;font-family:monospace;',SYNCERR_NONE}} を返します。これはレコードが破棄されたことを意味します。不成功時には以下のエラーコード値の 1 つを返します。 *{{span style='color:blue;font-family:monospace;',SYNCERR_COMM_NOT_INIT}} *{{span style='color:blue;font-family:monospace;',SYNCERR_LOST_CONNECTION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_SYS}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_MEM}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_BAD_ARG}} *{{span style='color:blue;font-family:monospace;',SYNCERR_NO_FILES_OPEN}} *{{span style='color:blue;font-family:monospace;',SYNCERR_BAD_OPERATION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_READ_ONLY}} *{{span style='color:blue;font-family:monospace;',SYNCERR_NOT_FOUND}} すべての同期マネージャエラーコードの記述は {{goto Common Sync Manager Error Codes,「共通同期マネージャエラーコード」|C/C++ Sync Suite Reference601/5}} を参照してください。 '''コメント''' この関数はただちにレコードのデータチャンクを処分し、データベースヘッダからレコードのエントリを削除します。レコードを削除する前に、データベースは読み込み、書き込み可能な状態でオープンされていなければいけません。あなたが削除したいレコードを指定するために、{{goto CR亜wRecordInfo,CRawRecordInfo}} クラスのオブジェクトを作成し、オブジェクトの {{span style='color:blue;font-family:monospace;',m_FileHandle}} メンバと {{span style='color:blue;font-family:monospace;',m_RecId}} メンバに情報を埋め込みます。レコードデータとデータベースのレコードリストの中にあるそのレコードのエントリは完全に削除されます。あなたが Palm OS のバージョン 2.0 よりも前のものを実行しているハンドヘルド上でレコードを削除した場合、HotSync 反復処理のインデックスは更新されないということに注意してください。反復処理中のデータベースの変更に伴う起こる可能性のある問題についての説明は ''C/C++ Sync Suite Companion'' の {{goto Modifying a Database While Iterating,「反復処理中のデータベースへの変更」|C/C++ Sync Suite Companion601/4}} を参照してください。 '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: すべてバージョンによる動作の違いについて「コメント」を参照してください。 '''参照''' {{goto CRawRecordInfo,CRawRecordInfo}} !{{anchor SyncDeleteResourceRec}}SyncDeleteResourceRec 関数 {{goto top,^TOP^}} '''目的''' クラシックデータベースからリソースを削除し、それのデータを処分します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' SInt32 SyncDeleteResourceRec ( CRawRecordInfo &rInfo ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ rInfo}} **レコードとデータベースについての情報を指定する {{goto CRawRecordInfo,CRawRecordInfo}} クラスのオブジェクト。呼び出し元は {{span style='color:blue;font-family:monospace;',m_FileHandle}} メンバ、{{span style='color:blue;font-family:monospace;',m_RecId}} メンバ、それに {{span style='color:blue;font-family:monospace;',m_RecIndex}} メンバを指定しなければなりません。 '''返り値''' 成功時には {{span style='color:blue;font-family:monospace;',SYNCERR_NONE}} を返します。これはリソースが破棄されたことを意味します。不成功時には以下のエラーコード値の 1 つを返します。 *{{span style='color:blue;font-family:monospace;',SYNCERR_COMM_NOT_INIT}} *{{span style='color:blue;font-family:monospace;',SYNCERR_LOST_CONNECTION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_SYS}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_MEM}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_BAD_ARG}} *{{span style='color:blue;font-family:monospace;',SYNCERR_NO_FILES_OPEN}} *{{span style='color:blue;font-family:monospace;',SYNCERR_BAD_OPERATION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_READ_ONLY}} *{{span style='color:blue;font-family:monospace;',SYNCERR_NOT_FOUND}} すべての同期マネージャエラーコードの記述は {{goto Common Sync Manager Error Codes,「共通同期マネージャエラーコード」|C/C++ Sync Suite Reference601/5}} を参照してください。 '''コメント''' この関数はただちにリソースのデータチャンクを処分し、データベースヘッダからリソースのエントリを削除します。リソースを削除する前に、データベースは読み込み、書き込み可能な状態でオープンされていなければいけません。あなたが削除したいリソースを指定するために、{{goto CR亜wRecordInfo,CRawRecordInfo}} クラスのオブジェクトを作成し、オブジェクトの {{span style='color:blue;font-family:monospace;',m_FileHandle}} メンバ、{{span style='color:blue;font-family:monospace;',m_RecId}} メンバ、それに {{span style='color:blue;font-family:monospace;',m_RecIndex}} メンバに情報を埋め込みます。 '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: すべて '''参照''' {{goto CRawRecordInfo,CRawRecordInfo}} !{{anchor SyncFindDbByName}}SyncFindDbByName 関数 {{goto top,^TOP^}} '''目的''' ハンドヘルド上でクラシックデータベースを名前とメモリカード番号で検索し、見つかった場合はそのデータベースについての情報を返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' SInt32 SyncFindDbByName ( SyncFindDbByNameParams &rParam, SyncDatabaseInfoType &rInfo ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ rParam}} **探すデータベースの名前、カード番号、オプションを指定するタイプ {{goto SyncFindDbByNameParams,SyncFindDbByNameParams}} の構造体。 *{{span style='color:blue;font-family:monospace;',← rInfo}} **見つかったデータベースについての情報を受け取るタイプ {{goto SyncDatabaseInfoType,SyncDatabaseInfoType}} の構造体。 '''返り値''' 成功時には {{span style='color:blue;font-family:monospace;',SYNCERR_NONE}} を返します。不成功時には以下のエラーコード値の 1 つを返します。 *{{span style='color:blue;font-family:monospace;',SYNCERR_COMM_NOT_INIT}} *{{span style='color:blue;font-family:monospace;',SYNCERR_LOST_CONNECTION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_SYS}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_MEM}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_BAD_ARG}} *{{span style='color:blue;font-family:monospace;',SYNCERR_NOT_FOUND}} すべての同期マネージャエラーコードの記述は {{goto Common Sync Manager Error Codes,「共通同期マネージャエラーコード」|C/C++ Sync Suite Reference601/5}} を参照してください。 '''コメント''' 名前でデータベースを検索するために、呼び出し元は {{span style='color:blue;font-family:monospace;',rParam}} で指される構造体にデータベース名と取得オプションを埋め込みます。この関数はデータベースについての情報を埋め込まれた構造体を戻してきます。この関数はクラシックデータベースに対してのみ検索を行います; この関数の検索には拡張データベースとスキーマデータベースは含まれません。 '''互換性''' 同期マネージャバージョン: 2.2 以降 *Palm OS バージョン: 3.0 以降 '''参照''' {{goto SyncFindDbByNameParams,SyncFindDbByNameParams}}, {{goto SyncDatabaseInfoType,SyncDatabaseInfoType}}, {{goto SyncFindDbByTypeCreator,SyncFindDbByTypeCreator()}} !{{anchor SyncFindDbByTypeCreator}}SyncFindDbByTypeCreator 関数 {{goto top,^TOP^}} '''目的''' ハンドヘルド上でクラシックデータベースをタイプと作成者 ID で検索し、見つかった場合はそのデータベースについての情報を返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' SInt32 SyncFindDbByTypeCreator ( SyncFindDbByTypeCreatorParams &rParam, SyncDatabaseInfoType &rInfo ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ rParam}} **探すデータベースの作成者、タイプ、オプションを指定するタイプ {{goto SyncFindDbByTypeCreatorParams,SyncFindDbByTypeCreatorParams}} の構造体。 *{{span style='color:blue;font-family:monospace;',← rInfo}} **見つかったデータベースについての情報を受け取るタイプ {{goto SyncDatabaseInfoType,SyncDatabaseInfoType}} の構造体。 '''返り値''' 成功時には {{span style='color:blue;font-family:monospace;',SYNCERR_NONE}} を返します。不成功時には以下のエラーコード値の 1 つを返します。 *{{span style='color:blue;font-family:monospace;',SYNCERR_COMM_NOT_INIT}} *{{span style='color:blue;font-family:monospace;',SYNCERR_LOST_CONNECTION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_SYS}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_MEM}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_BAD_ARG}} *{{span style='color:blue;font-family:monospace;',SYNCERR_NOT_FOUND}} すべての同期マネージャエラーコードの記述は {{goto Common Sync Manager Error Codes,「共通同期マネージャエラーコード」|C/C++ Sync Suite Reference601/5}} を参照してください。 '''コメント''' タイプと作成者 ID でデータベースを検索するために、呼び出し元は {{span style='color:blue;font-family:monospace;',rParam}} で指される構造体にデータベースタイプ、作成者 ID、それに取得オプションを埋め込みます。この関数はデータベースについての情報を埋め込まれた構造体を戻してきます。あなたはこの関数を使ってある特定のタイプまたは作成者 ID を持つ複数のデータベースを列挙することができます。ある特定の作成者 ID/タイプのペアに対して新しい検索を開始するには、呼び出し元は {{span style='color:blue;font-family:monospace;',rParam}} の {{span style='color:blue;font-family:monospace;',bSrchFlags}} フィールドに {{span style='color:blue;font-family:monospace;',SYNC_DB_SRCH_OPT_NEW_SEARCH}} フラグを指定しなければなりません。開始後にその後に続く呼び出しはこのフラグを含まないようにしなければなりません。この関数はデータベース列挙の中にあるデータベースの作成や削除をサポートしないということに注意してください。この関数はクラシックデータベースに対してのみ検索を行います; この関数の検索には拡張データベースとスキーマデータベースは含まれません。 '''互換性''' 同期マネージャバージョン: 2.2 以降 *Palm OS バージョン: 3.0 以降 '''参照''' {{goto SyncFindDbByTypeCreatorParams,SyncFindDbByTypeCreatorParams}}, {{goto SyncDatabaseInfoType,SyncDatabaseInfoType}}, {{goto SyncFindDbByName,SyncFindDbByName()}} !{{anchor SyncGetDBRecordCount}}SyncGetDBRecordCount 関数 {{goto top,^TOP^}} '''目的''' ハンドヘルド上のクラシックデータベースの総レコードまたはリソース数を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' SInt32 SyncGetDBRecordCount ( HSByte fHandle, UInt16 &rNumRecs ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ fHandle}} **ハンドヘルド上のクラシックデータベースへのハンドル。このハンドルは {{goto SyncOpenDB,SyncOpenDB()}} または {{goto SyncCreateDB,SyncCreateDB()}} 呼び出しによって返されます。 *{{span style='color:blue;font-family:monospace;',← nNumRecs}} **データベースの中にあるレコードまたはリソースの数。 '''返り値''' 成功時には {{span style='color:blue;font-family:monospace;',SYNCERR_NONE}} を返します。不成功時には以下のエラーコード値の 1 つを返します。 *{{span style='color:blue;font-family:monospace;',SYNCERR_COMM_NOT_INIT}} *{{span style='color:blue;font-family:monospace;',SYNCERR_LOST_CONNECTION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_SYS}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_BAD_ARG}} *{{span style='color:blue;font-family:monospace;',SYNCERR_NO_FILES_OPEN}} すべての同期マネージャエラーコードの記述は {{goto Common Sync Manager Error Codes,「共通同期マネージャエラーコード」|C/C++ Sync Suite Reference601/5}} を参照してください。 '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: すべて '''参照''' {{goto SyncOpenDB,SyncOpenDB()}}, {{goto SyncCreateDB,SyncCreateDB()}} !{{anchor SyncMaxRemoteRecSize}}SyncMaxRemoteRecSize 関数 {{goto top,^TOP^}} '''目的''' ハンドヘルドじょのクラシックデータベースでサポートされるレコードまたはリソースの最大サイズを取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' SInt32 SyncMaxRemoteRecSize ( UInt32 &rdwMaxRecSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',← rdwMaxRecSize}} **ハンドヘルド上に割り当てることができるレコードの最大サイズ (バイト数)。この値は許可される最大サイズです; ある特定のタイミングで割り当て可能な実際の最大サイズは利用可能なメモリ次第です。以下の特別な値に注意してください: {{div_begin style="margin-left:5em;"}} *{{span style='color:blue;font-family:monospace;',0}} **最大レコードサイズはわからないということを示しています。 *{{span style='color:blue;font-family:monospace;',0xFFFFFFFF}} **サイズに制限が無い - 利用可能なメモリ次第では - ということを示しています。 {{div_end}} '''返り値''' 成功時には {{span style='color:blue;font-family:monospace;',SYNCERR_NONE}} を返します。不成功時には以下のエラーコード値の 1 つを返します。 *{{span style='color:blue;font-family:monospace;',SYNCERR_COMM_NOT_INIT}} *{{span style='color:blue;font-family:monospace;',SYNCERR_LOST_CONNECTION}} すべての同期マネージャエラーコードの記述は {{goto Common Sync Manager Error Codes,「共通同期マネージャエラーコード」|C/C++ Sync Suite Reference601/5}} を参照してください。 '''コメント''' {{goto Table 4.3,表 4.3}} は Palm OS のバージョンでサポートされる最大レコードサイズについてを提供しています。 {{anchor Table 4.3}} '''表 4.3 クラシックデータベースの最大レコードサイズ''' ,Palm OS バージョン,最大レコードサイズ (バイト数) ,< 3.0,"64,720" ,>= 3.0,"65,505" ---- '''NOTE:'''同期マネージャバージョン 2.4 以降はハンドヘルド上の Palm OS のバージョンに関係なく値 65,505 だけを返してきます。 ---- '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: すべて !{{anchor SyncOpenDB}}SyncOpenDB 関数 {{goto top,^TOP^}} '''目的''' ハンドヘルド上の既存のクラシックデータベースをオープンします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' SInt32 SyncOpenDB ( const char *pName, SInt32 nCardNum, HSByte &rHandle, HSByte openMode = ( eDbWrite | eDbRead | eDbExclusive ) ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pName}} **オープンするクラシックデータベースの名前。これは null で終了する文字配列です。 *{{span style='color:blue;font-family:monospace;',→ nCardNum}} **データベースが存在しているメモリカードの番号。システムの最初のメモリカードはカード番号 0 であり、それに続くカード番号は +1 されます。複数の Palm OS メモリカードをサポートするある特定の HandSpring ハンドヘルドを除き、常に 0 を指定します。 *{{span style='color:blue;font-family:monospace;',← rHandle}} **返されるクラシックデータベースへのハンドル。 *{{span style='color:blue;font-family:monospace;',→ openMode}} **どのようにデータベースをオープンするか - 例えば、読み込み、書き込みできるようにオープンする - を指定する 1 つまたはそれ以上の {{goto eDbOpenModes,eDbOpenModes|C/C++ Sync Suite Reference601/5}} 値の組み合わせ。 '''返り値''' 成功時には {{span style='color:blue;font-family:monospace;',SYNCERR_NONE}} を返します。これはデータベースがオープンされたことを意味します。不成功時には以下のエラーコード値の 1 つを返します。 *{{span style='color:blue;font-family:monospace;',SYNCERR_COMM_NOT_INIT}} *{{span style='color:blue;font-family:monospace;',SYNCERR_LOST_CONNECTION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_SYS}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_MEM}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_BAD_ARG}} *{{span style='color:blue;font-family:monospace;',SYNCERR_NOT_FOUND}} *{{span style='color:blue;font-family:monospace;',SYNCERR_TOO_MANY_OPEN_FILES}} *{{span style='color:blue;font-family:monospace;',SYNCERR_FILE_NOT_OPEN}} *{{span style='color:blue;font-family:monospace;',SYNCERR_FILE_ALREADY_OPEN}} すべての同期マネージャエラーコードの記述は {{goto Common Sync Manager Error Codes,「共通同期マネージャエラーコード」|C/C++ Sync Suite Reference601/5}} を参照してください。 '''コメント''' 同期マネージャは常にクラシックデータベースを 1 つだけオープンさせておくことを許可します; それゆえ、あなたはこの関数を呼び出す前にオープンされているクラシックデータベースをクローズしなければなりません。さもなければ、他のコンジットはクラシックデータベースをオープンすることができなくなります。 '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: すべて '''参照''' {{goto eDbOpenModes,eDbOpenModes|C/C++ Sync Suite Reference601/5}}, {{goto SyncCloseDB,SyncCloseDB()}}, {{goto SyncCloseDBEx,SyncCloseDBEx()}} !{{anchor SyncPurgeAllRecs}}SyncPurgeAllRecs 関数 {{goto top,^TOP^}} '''目的''' レコードステータスに関係なく、クラシックデータベースからすべてのレコードを削除し、それらのデータを処分します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' SInt32 SyncPurgeAllRecs ( HSByte fHandle ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ fHandle}} **ハンドヘルド上のクラシックレコードデータベースへのハンドル。このハンドルは {{goto SyncOpenDB,SyncOpenDB()}} または {{goto SyncCreateDB,SyncCreateDB()}} 呼び出しによって返されます。 '''返り値''' 成功時には {{span style='color:blue;font-family:monospace;',SYNCERR_NONE}} を返します。また、データベースがレコードを持たない場合も {{span style='color:blue;font-family:monospace;',SYNCERR_NONE}} を返します。不成功時には以下のエラーコード値の 1 つを返します。 *{{span style='color:blue;font-family:monospace;',SYNCERR_COMM_NOT_INIT}} *{{span style='color:blue;font-family:monospace;',SYNCERR_LOST_CONNECTION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_SYS}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_MEM}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_BAD_ARG}} *{{span style='color:blue;font-family:monospace;',SYNCERR_READ_ONLY}} *{{span style='color:blue;font-family:monospace;',SYNCERR_BAD_OPERATION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_NO_FILES_OPEN}} すべての同期マネージャエラーコードの記述は {{goto Common Sync Manager Error Codes,「共通同期マネージャエラーコード」|C/C++ Sync Suite Reference601/5}} を参照してください。 '''コメント''' この関数はただちにすべてのレコードのデータチャンクを処分し、データベースヘッダからレコードのエントリを削除します。 '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: すべて '''参照''' {{goto SyncOpenDB,SyncOpenDB()}}, {{goto SyncCreateDB,SyncCreateDB()}}, {{goto SyncPurgeAllRecsInCategory,SyncPurgeAllRecsInCategory()}, {{goto SyncPurgeDeletedRecs,SyncPurgeDeletedRecs()}} !{{anchor SyncPurgeAllRecsInCategory}}SyncPurgeAllRecsInCategory 関数 {{goto top,^TOP^}} '''目的''' レコードステータスに関係なく、クラシックデータベースから指定されたカテゴリの中にあるすべてのレコードを削除し、それらのデータを処分します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' SInt32 SyncPurgeAllRecsInCategory ( HSByte fHandle, SInt16 category ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ fHandle}} **ハンドヘルド上のクラシックレコードデータベースへのハンドル。このハンドルは {{goto SyncOpenDB,SyncOpenDB()}} または {{goto SyncCreateDB,SyncCreateDB()}} 呼び出しによって返されます。 *{{span style='color:blue;font-family:monospace;',→ category}} **あなたが消去したいレコードが属しているカテゴリのインデックス。慣例では、値 0 は未分類カテゴリに使用し、1 から 15 までの値は分類カテゴリに使用します。 '''返り値''' 成功時には {{span style='color:blue;font-family:monospace;',SYNCERR_NONE}} を返します。また、データベースがレコードを持たない場合も {{span style='color:blue;font-family:monospace;',SYNCERR_NONE}} を返します。不成功時には以下のエラーコード値の 1 つを返します。 *{{span style='color:blue;font-family:monospace;',SYNCERR_COMM_NOT_INIT}} *{{span style='color:blue;font-family:monospace;',SYNCERR_LOST_CONNECTION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_SYS}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_MEM}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_BAD_ARG}} *{{span style='color:blue;font-family:monospace;',SYNCERR_NO_FILES_OPEN}} *{{span style='color:blue;font-family:monospace;',SYNCERR_BAD_OPERATION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_READ_ONLY}} すべての同期マネージャエラーコードの記述は {{goto Common Sync Manager Error Codes,「共通同期マネージャエラーコード」|C/C++ Sync Suite Reference601/5}} を参照してください。 '''コメント''' 指定されたデータベースとカテゴリに対して、この関数はただちにすべてのレコードのデータチャンクを処分し、データベースヘッダからレコードのエントリを削除します。 '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: 2.0 以降 '''参照''' {{goto SyncOpenDB,SyncOpenDB()}}, {{goto SyncCreateDB,SyncCreateDB()}} !{{anchor SyncPurgeDeletedRecs}}SyncPurgeDeletedRecs 関数 {{goto top,^TOP^}} '''目的''' クラシックデータベースから「削除された」または「アーカイブされた」というマークを付けられたすべてのレコードを削除し、それらのデータを処分します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',SyncMgr.h}} '''Prototype''' SInt32 SyncPurgeDeletedRecs ( HSByte fHandle ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',fHandle}} **ハンドヘルド上のクラシックレコードデータベースへのハンドル。このハンドルは {{goto SyncOpenDB,SyncOpenDB()}} または {{goto SyncCreateDB,SyncCreateDB()}} 呼び出しによって返されます。 '''返り値''' 成功時には {{span style='color:blue;font-family:monospace;',SYNCERR_NONE}} を返します。また、データベースがレコードを持たない場合も {{span style='color:blue;font-family:monospace;',SYNCERR_NONE}} を返します。不成功時には以下のエラーコード値の 1 つを返します。 *{{span style='color:blue;font-family:monospace;',SYNCERR_COMM_NOT_INIT}} *{{span style='color:blue;font-family:monospace;',SYNCERR_LOST_CONNECTION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_SYS}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_MEM}} *{{span style='color:blue;font-family:monospace;',SYNCERR_REMOTE_BAD_ARG}} *{{span style='color:blue;font-family:monospace;',SYNCERR_READ_ONLY}} *{{span style='color:blue;font-family:monospace;',SYNCERR_BAD_OPERATION}} *{{span style='color:blue;font-family:monospace;',SYNCERR_NO_FILES_OPEN}} すべての同期マネージャエラーコードの記述は {{goto Common Sync Manager Error Codes,「共通同期マネージャエラーコード」|C/C++ Sync Suite Reference601/5}} を参照してください。 '''コメント''' 削除ビットがセットされているすべてのレコードに対して、この関数はただちにすべてのレコードのデータチャンクを処分し、データベースヘッダからレコードのエントリを削除します。 {{span style='color:blue;font-family:monospace;',fHandle}} パラメータは読み込み、書き込み可能状態でオープンされているクラシックデータベースを指定しなければなりません。 '''互換性''' 同期マネージャバージョン: 2.0 以降 *Palm OS バージョン: すべて '''参照''' {{goto SyncOpenDB,SyncOpenDB()}}, {{goto SyncCreateDB,SyncCreateDB()}} [[↑　4 章のトップへ|C/C++ Sync Suite Reference601/4]]　[[4 章のページ 2 へ　→|C/C++ Sync Suite Reference601/4-2]] {{div_end}} {{div_begin "style='border-top-style:solid;border-top-width:1px;border-top-color:silver;'"}} [[←　3 章に戻る|C/C++ Sync Suite Reference601/3]]　[[↑トップへ|C/C++ Sync Suite Reference601]]　[[5 章に進む　→|C/C++ Sync Suite Reference601/5]] {{div_end}}