{{div_begin}} [[← 10 章に戻る|C/C++ Sync Suite Reference601/10]] [[↑トップへ|C/C++ Sync Suite Reference601]] [[12 章に進む →|C/C++ Sync Suite Reference601/12]] {{div_end}} {{div_begin style="margin-bottom:-10px"}} !!!11 コンジット マネージャ API (ページ 1) {{div_end}} {{div_begin "style='position:absolute;right:0px;font-size:70%;margin-right:15px;margin-top:15px;width:250px;'"}} *(ページ 1) *{{goto Conduit Manager Structures,コンジット マネージャ構造体}} **{{goto CmConduitType,CmConduitType}} **{{goto CmConduitType2,CmConduitType2}} **{{goto CmDiscoveryInfoType,CmDiscoveryInfoType}} **{{goto CM_CREATORLIST_ITEM_TYPE,CM_CREATORLIST_ITEM_TYPE}} *{{goto Conduit Manager Constants,コンジット マネージャ定数}} **{{goto Conduit Information Types,コンジット情報タイプ}} **{{goto Communications Ports,通信ポート}} **{{goto Conduit Manager Versions,コンジット マネージャ バージョン}} **{{goto Miscellaneous Constants,その他の定数}} *{{goto Conduit Manager Functions,コンジット マネージャ関数}} **{{goto CmConvertCreatorIDToString,CmConvertCreatorIDToString}} **{{goto CmConvertStringToCreatorID,CmConvertStringToCreatorID}} **{{goto CmGetBackupConduit,CmGetBackupConduit}} **{{goto CmGetComPort,CmGetComPort}} **{{goto CmGetConduitByCreator,CmGetConduitByCreator}} **{{goto CmGetConduitByIndex,CmGetConduitByIndex}} **{{goto CmGetConduitCount,CmGetConduitCount}} **{{goto CmGetConduitCreatorID,CmGetConduitCreatorID}} **{{goto CmGetCorePath,CmGetCorePath}} **{{goto CmGetCreatorArgument,CmGetCreatorArgument}} **{{goto CmGetCreatorDirectory,CmGetCreatorDirectory}} **{{goto CmGetCreatorFile,CmGetCreatorFile}} **{{goto CmGetCreatorIDList,CmGetCreatorIDList}} **{{goto CmGetCreatorInfo,CmGetCreatorInfo}} **{{goto CmGetCreatorIntegrate,CmGetCreatorIntegrate}} **{{goto CmGetCreatorModule,CmGetCreatorModule}} **{{goto CmGetCreatorName,CmGetCreatorName}} **{{goto CmGetCreatorPriority,CmGetCreatorPriority}} **{{goto CmGetCreatorRemote,CmGetCreatorRemote}} **{{goto CmGetCreatorTitle,CmGetCreatorTitle}} **{{goto CmGetCreatorType,CmGetCreatorType}} **{{goto CmGetCreatorUser,CmGetCreatorUser}} **{{goto CmGetCreatorValueDword,CmGetCreatorValueDword}} **{{goto CmGetCreatorValueString,CmGetCreatorValueString}} *(ページ 2) **{{goto CmGetDiscoveryInfoByIndex,CmGetDiscoveryInfoByIndex|C/C++ Sync Suite Reference601/11-2}} **{{goto CmGetHotSyncExecPath,CmGetHotSyncExecPath|C/C++ Sync Suite Reference601/11-2}} **{{goto CmGetLibVersion,CmGetLibVersion|C/C++ Sync Suite Reference601/11-2}} **{{goto CmGetNotifierDll,CmGetNotifierDll|C/C++ Sync Suite Reference601/11-2}} **{{goto CmGetPCIdentifier,CmGetPCIdentifier|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 CmInstallConduit,CmInstallConduit|C/C++ Sync Suite Reference601/11-2}} **{{goto CmInstallConduitByStruct,CmInstallConduitByStruct|C/C++ Sync Suite Reference601/11-2}} **{{goto CmInstallCreator,CmInstallCreator|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 CmRemoveConduitByCreatorID,CmRemoveConduitByCreatorID|C/C++ Sync Suite Reference601/11-2}} **{{goto CmRemoveConduitByIndex,CmRemoveConduitByIndex|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 CmRestoreHotSyncSettings,CmRestoreHotSyncSettings|C/C++ Sync Suite Reference601/11-2}} *(ページ 3) **{{goto CmSetBackupConduit,CmSetBackupConduit|C/C++ Sync Suite Reference601/11-3}} **{{goto CmSetComPort,CmSetComPort|C/C++ Sync Suite Reference601/11-3}} **{{goto CmSetCorePath,CmSetCorePath|C/C++ Sync Suite Reference601/11-3}} **{{goto CmSetCreatorArgument,CmSetCreatorArgument|C/C++ Sync Suite Reference601/11-3}} **{{goto CmSetCreatorDirectory,CmSetCreatorDirectory|C/C++ Sync Suite Reference601/11-3}} **{{goto CmSetCreatorFile,CmSetCreatorFile|C/C++ Sync Suite Reference601/11-3}} **{{goto CmSetCreatorInfo,CmSetCreatorInfo|C/C++ Sync Suite Reference601/11-3}} **{{goto CmSetCreatorIntegrate,CmSetCreatorIntegrate|C/C++ Sync Suite Reference601/11-3}} **{{goto CmSetCreatorModule,CmSetCreatorModule|C/C++ Sync Suite Reference601/11-3}} **{{goto CmSetCreatorName,CmSetCreatorName|C/C++ Sync Suite Reference601/11-3}} **{{goto CmSetCreatorPriority,CmSetCreatorPriority|C/C++ Sync Suite Reference601/11-3}} **{{goto CmSetCreatorRemote,CmSetCreatorRemote|C/C++ Sync Suite Reference601/11-3}} **{{goto CmSetCreatorTitle,CmSetCreatorTitle|C/C++ Sync Suite Reference601/11-3}} **{{goto CmSetCreatorUser,CmSetCreatorUser|C/C++ Sync Suite Reference601/11-3}} **{{goto CmSetCreatorValueDword,CmSetCreatorValueDword|C/C++ Sync Suite Reference601/11-3}} **{{goto CmSetCreatorValueString,CmSetCreatorValueString|C/C++ Sync Suite Reference601/11-3}} **{{goto CmSetHotSyncExecPath,CmSetHotSyncExecPath|C/C++ Sync Suite Reference601/11-3}} **{{goto CmSetNotifierDll,CmSetNotifierDll|C/C++ Sync Suite Reference601/11-3}} **{{goto CmSetPCIdentifier,CmSetPCIdentifier|C/C++ Sync Suite Reference601/11-3}} **{{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 FmGetCurrentUserConduitByIndex,FmGetCurrentUserConduitByIndex|C/C++ Sync Suite Reference601/11-3}} **{{goto FmGetCurrentUserConduitCount,FmGetCurrentUserConduitCount|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}} *{{goto Conduit Manager Error Codes,コンジット マネージャ エラー コード|C/C++ Sync Suite Reference601/11-3}} {{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;'"}} [[↑ 11 章のトップへ|C/C++ Sync Suite Reference601/11]] [[11 章のページ 2 へ →|C/C++ Sync Suite Reference601/11-2]] !!{{anchor Conduit Manager Structures}}コンジット マネージャ構造体 {{goto top,^TOP^}} !{{anchor CmConduitType}}CmConduitType 構造体 {{goto top,^TOP^}} '''目的''' あなたがコンジットを登録するために {{goto CmInstallConduit,CmInstallConduit()}} に渡すコンジット登録情報を指定します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' typedef struct { int iStructureVersion; int iStructureSize; int iType; char szCreatorID[CM_CREATOR_ID_SIZE]; DWORD dwPriority; int iConduitNameOffset; int iDirectoryOffset; int iFileOffset; int iRemoteDBOffset; int iUsernameOffset; int iTitleOffset; int iInfoOffset; } CmConduitType '''フィールド''' *{{span style='color:blue;font-family:monospace;',iStructureVersion}} **呼び出し元が使用しているこのデータ構造体のバージョン - これは {{goto Miscellaneous Constants,「その他の定数」}} の中の定数 {{span style='color:blue;font-family:monospace;',CONDUIT_VERSION}} として定義されています - を指定します。コンジット マネージャはこの値を使って構造体の中の情報をどのように処理するかを決定します。 *{{span style='color:blue;font-family:monospace;',iStructureSize}} **構造体のサイズをバイト数で指定します。 *{{span style='color:blue;font-family:monospace;',iType}} **{{goto Conduit Information Types,「コンジット情報タイプ」}} で説明されているコンジット情報タイプを指定します。 *{{span style='color:blue;font-family:monospace;',szCreatorID[CM_CREATOR_ID_SIZE]}} **{{goto Creator 1,Creator|Introduction to Conduit Development601/A}} でセットされているコンジットの作成者 ID を指定します。 *{{span style='color:blue;font-family:monospace;',dwPriority}} **コンジットの {{goto Priority 1,Priority|Introduction to Conduit Development601/A}} を指定します。 *{{span style='color:blue;font-family:monospace;',iConduitNameOffset}} **この構造体の開始点から {{goto Conduit 1,Conduit|Introduction to Conduit Development601/A}} にセットされているコンジット名文字列の最初の文字までのオフセットを指定します。 *{{span style='color:blue;font-family:monospace;',iDirectoryOffset}} **この構造体の開始点から {{goto Directory 1,Directory|Introduction to Conduit Development601/A}} にセットされているディレクトリ名文字列の最初の文字までのオフセットを指定します。 *{{span style='color:blue;font-family:monospace;',iFileOffset}} **この構造体の開始点から {{goto File 1,File|Introduction to Conduit Development601/A}} にセットされているファイル名文字列の最初の文字までのオフセットを指定します。 *{{span style='color:blue;font-family:monospace;',iRemoteDBOffset}} **この構造体の開始点から {{goto Remote 1,Remote|Introduction to Conduit Development601/A}} にセットされているハンドヘルド データベース名文字列の最初の文字までのオフセットを指定します。 *{{span style='color:blue;font-family:monospace;',iUsernameOffset}} **この構造体の開始点から {{goto Username 1,Username|Introduction to Conduit Development601/A}} にセットされているユーザ名文字列の最初の文字までのオフセットを指定します。 *{{span style='color:blue;font-family:monospace;',iTitleOffset}} **この構造体の開始点から {{goto Name 1,Name|Introduction to Conduit Development601/A}} にセットされているタイトル文字列の最初の文字までのオフセットを指定します。 *{{span style='color:blue;font-family:monospace;',iInfoOffset}} **この構造体の開始点から {{goto Information 1,Information|Introduction to Conduit Development601/A}} にセットされている情報文字列の最初の文字までのオフセットを指定します。 '''コメント''' {{span style='color:blue;font-family:monospace;',CmConduitType}} 構造体はいくつかの文字列を含みます。各文字列は構造体フィールドの後に保存されます。この構造体は各文字列のオフセット フィールドを含みます; 各オフセットはこの構造体の開始点からその文字列の開始点までのバイト数を指定します。 ::NOTE :::{{span style='color:blue;font-family:monospace;',CmConduitType}} 構造体は CDK バージョン 6.0 以降では使用を推奨されなくなったいくつかのコンジット コンフィグレーション エントリのフィールドを含みます。PalmSource は代わりに {{goto CmConduitType2,CmConduitType2}} を {{goto CmInstallConduitByStruct,CmInstallConduitByStruct()|C/C++ Sync Suite Reference601/11-2}} や {{goto CmInstallSystemConduitByStruct,CmInstallSystemConduitByStruct()|C/C++ Sync Suite Reference601/11-2}} とともに使用することを推奨します。 この構造体を使ってのコンジットの登録についての更なる情報は、''C/C++ Sync Suite Companion'' の {{goto Writing a Single Structure,「単一の構造体を作成する」|C/C++ Sync Suite Companion601/9-1}} を参照してください。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmInstallConduit,CmInstallConduit()|C/C++ Sync Suite Reference601/11-2}} !{{anchor CmConduitType2}}CmConduitType2 構造体 {{goto top,^TOP^}} '''目的''' あなたがコンジットを登録するときに渡す、あるいは、あなたがコンジットについての情報を要求したときにコンジット マネージャから渡されるコンジット登録情報を定義します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' typedef struct { DWORD dwCreatorID; DWORD dwPriority; TCHAR szConduitPath[255]; TCHAR szLocalDirectory[255]; TCHAR szLocalFile[255]; TCHAR szRemoteDB[32]; TCHAR szTitle[255]; } CmConduitType2 '''フィールド''' *{{span style='color:blue;font-family:monospace;',dwCreatorID}} **登録するコンジットの作成者 ID を定義します。この値はコンジットの {{goto Creator 1,Creator|Introduction to Conduit Development601/A}} コンフィグレーション エントリにセットされます。 *{{span style='color:blue;font-family:monospace;',dwPriority}} **HotSync マネージャが登録するコンジットを実行する優先順位を定義します。この値はコンジットの {{goto Priority 1,Priority|Introduction to Conduit Development601/A}} コンフィグレーション エントリにセットされます。 *{{span style='color:blue;font-family:monospace;',szConduitPath}} **登録するコンジットのフル パスとファイル名(またはファイル名だけ)を定義します。この値はコンジットの {{goto Conduit 1,Conduit|Introduction to Conduit Development601/A}} コンフィグレーション エントリにセットされます。 *{{span style='color:blue;font-family:monospace;',szLocalDirectory}} **登録するコンジットのディレクトリ名を定義します。この値はコンジットの {{goto Directory 1,Directory|Introduction to Conduit Development601/A}} コンフィグレーション エントリにセットされます。 *{{span style='color:blue;font-family:monospace;',szLocalFile}} **登録するコンジットが同期をとるデスクトップ ファイルを定義します。この値はコンジットの {{goto File 1,File|Introduction to Conduit Development601/A}} コンフィグレーション エントリにセットされます。 *{{span style='color:blue;font-family:monospace;',szRemoteDB}} **登録するコンジットが同期をとるハンドヘルド上のデータベースの名前を定義します。コンジットはいくつのデータベースに対しても読み込み、書き込みを行えるので、この値はオプションであることに注意してください。この値はコンジットの {{goto Remote 1,Remote|Introduction to Conduit Development601/A}} コンフィグレーション エントリにセットされます。 *{{span style='color:blue;font-family:monospace;',szTitle}} **登録する表示名を定義します。この値はコンジットの {{goto Name 1,Name|Introduction to Conduit Development601/A}} コンフィグレーション エントリにセットされます。 '''コメント''' この構造体はコンジット マネージャ バージョン 3 以降で導入される API によって、コンジットについての情報にアクセスするために使用されます。この構造体を使用する関数は以下の「参照」部でリスト アップされています。この構造体の各フィールドはコンジット コンフィグレーション エントリに対応します({{goto Table A.1,表 A.1|Introduction to Conduit Development601/A}} を参照してください)。 この構造体は {{goto CmConduitType,CmConduitType}} 構造体に比べて 2 つの長所があります。{{goto CmConduitType2,CmConduitType2}} 構造体は: *サイズが固定されています。そのため、関数パラメータとして渡すのがより容易です。 *必須のコンジット コンフィグレーション エントリとたいていのコンジットで使用されるいくつかのオプションのコンジット コンフィグレーション エントリだけを含みます。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmGetConduitByIndex,CmGetConduitByIndex()}}, {{goto CmGetSystemConduitByCreator,CmGetSystemConduitByCreator()|C/C++ Sync Suite Reference601/11-2}}, {{goto CmGetSystemConduitByIndex,CmGetSystemConduitByIndex()|C/C++ Sync Suite Reference601/11-2}}, {{goto CmInstallConduitByStruct,CmInstallConduitByStruct()|C/C++ Sync Suite Reference601/11-2}}, {{goto CmInstallSystemConduitByStruct,CmInstallSystemConduitByStruct()|C/C++ Sync Suite Reference601/11-2}}, {{goto FmGetCurrentUserConduitByIndex,FmGetCurrentUserConduitByIndex()|C/C++ Sync Suite Reference601/11-3}}, {{goto FmGetSystemConduitByIndex,FmGetSystemConduitByIndex()|C/C++ Sync Suite Reference601/11-3}} !{{anchor CmDiscoveryInfoType}}CmDiscoveryInfoType 構造体 {{goto top,^TOP^}} '''目的''' HotSync マネージャがどのようにコンジットを見つけ出すかについての情報を受け取ります。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' typedef struct { BOOL bDiscoverableViaFolder; BOOL bDiscoverableViaRegistry; BOOL bLoadable; } CmDiscoveryInfoType '''フィールド''' *{{span style='color:blue;font-family:monospace;',bDiscoverableViaFolder}} **コンジットがフォルダ登録である場合、つまりコンジット マネージャがシステムまたはユーザの {{span style='color:blue;font-family:monospace;',Conduits}} フォルダの中でコンジットを見つけ出した場合、{{span style='color:blue;font-family:monospace;',TRUE}} を受け取ります。 *{{span style='color:blue;font-family:monospace;',bDiscoverableViaRegistry}} **コンジットが通常通りの方法で登録されていた場合、つまり HotSync マネージャがコンジット コンフィグレーション エントリを参照することによってコンジットを見つけ出した場合、{{span style='color:blue;font-family:monospace;',TRUE}} を受け取ります。 *{{span style='color:blue;font-family:monospace;',bLoadable}} **HotSync マネージャがコンジットのロードに成功できた場合、{{span style='color:blue;font-family:monospace;',TRUE}} を受け取ります。 '''コメント''' フィールド {{span style='color:blue;font-family:monospace;',bDiscoverableViaFolder}} と {{span style='color:blue;font-family:monospace;',bDiscoverableViaRegistry}} の中のブール値は互いに排他です。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmGetDiscoveryInfoByIndex,CmGetDiscoveryInfoByIndex()|C/C++ Sync Suite Reference601/11-2}}, {{goto CmGetSystemDiscoveryInfoByIndex,CmGetSystemDiscoveryInfoByIndex()|C/C++ Sync Suite Reference601/11-2}} !{{anchor CM_CREATORLIST_ITEM_TYPE}}CM_CREATORLIST_ITEM_TYPE 構造体 {{goto top,^TOP^}} '''目的''' コンジットに関連付けられたクリエイタ ID を受け取ります。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' typedef struct { char szCreatorID[CM_CREATOR_ID_SIZE]; int iReserved; } CM_CREATORLIST_ITEM_TYPE typedef CM_CREATORLIST_ITEM_TYPE *CM_CREATORLIST_TYPE '''フィールド''' *{{span style='color:blue;font-family:monospace;',szCreatorID}} **コンジットに関連付けられたクリエイタ ID を受け取ります。 *{{span style='color:blue;font-family:monospace;',iReserved}} **整数値を受け取ります。これは将来使用するために予約されています。 '''コメント''' {{span style='color:blue;font-family:monospace;',CM_CREATORLIST_TYPE}} は {{goto CmGetCreatorIDList,CmGetCreatorIDList}} によって返される {{span style='color:blue;font-family:monospace;',CM_CREATORLIST_ITEM_TYPE}} 構造体の配列へのポインタとして定義されています。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmGetCreatorIDList,CmGetCreatorIDList}} !!{{anchor Conduit Manager Constants}}コンジット マネージャ定数 {{goto top,^TOP^}} この節では、あなたがコンジット マネージャ API で使用するプロセッサ定数の以下のグループについて説明します。 ,定数,説明 ,"{{goto Conduit Information Types,コンジット情報タイプ}}","コンジットのタイプを定義します。コンジットのタイプはそのコンジットによって使用される情報の場所を定義します。" ,"{{goto Communications Ports,通信ポート}}","COM ポートを取得、セットするための接続のタイプを示します。" ,"{{goto Conduit Manage Versions,コンジット マネージャ バージョン}}","{{goto CmGetLibVersion,CmGetLibVersion()|C/C++ Sync Suite Reference601/11-2}} が返すコンジット マネージャのバージョン番号を定義します。" ,"{{goto Miscellaneous Constants,その他の定数}}","コンジット マネージャで使用するその他の定数を定義します。" !{{anchor Conduit Information Types}}コンジット情報タイプ {{goto top,^TOP^}} '''目的''' コンジットのタイプを定義します。コンジットのタイプはそのコンジットによって使用される情報の場所を定義します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''定数''' *{{span style='color:blue;font-family:monospace;',#define CONDUIT_APPLICATION 1}} **コンジット情報がアプリケーション情報の場所に保存されていることを示します。 *{{span style='color:blue;font-family:monospace;',#define CONDUIT_COMPONENT 0}} **コンジット情報がコンポーネント情報の場所に保存されていることを示します。 *{{span style='color:blue;font-family:monospace;',#define CONDUIT_CONDUITS 10}} *将来使用するためのものです。コンジット情報がコンジット集団の情報の場所に保存されていることを示します。 '''コメント''' {{goto CmInstallCreator,CmInstallCreator()|C/C++ Sync Suite Reference601/11-2}} または {{goto CmInstallCoduit,CmInstallConduit()|C/C++ Sync Suite Reference601/11-2}} を呼び出しているときにこれらの値の 1 つを指定します。ほとんどすべてのコンジットに対して、{{span style='color:blue;font-family:monospace;',CONDUIT_APPLICATION}} を指定します。PalmSource は、代わりに {{goto CmInstallConduitByStruct,CmInstallConduitByStruct()|C/C++ Sync Suite Reference601/11-2}} を使用することを推奨します。この関数はあなたがこれらの値の 1 つを指定することを必要としません。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmInstallCreator,CmInstallCreator()|C/C++ Sync Suite Reference601/11-2}}, {{goto CmInstallConduit,CmInstallConduit()|C/C++ Sync Suite Reference601/11-2}} !{{anchor Communications Ports}}通信ポート {{goto top,^TOP^}} '''目的''' COM ポートを取得、セットするための接続のタイプを示します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''定数''' *{{span style='color:blue;font-family:monospace;',#define DIRECT_COM_PORT 0}} **HotSync マネージャのコンフィグレーション エントリの中の {{span style='color:blue;font-family:monospace;',DirectComPort}} エントリを指定します。 *{{span style='color:blue;font-family:monospace;',#define MODEM_COM_PORT 1}} **HotSync マネージャのコンフィグレーション エントリの中の {{span style='color:blue;font-family:monospace;',ModemComPort}} エントリを指定します。 *{{span style='color:blue;font-family:monospace;',#define MAX_COM_PORT MODEM_COM_PORT}} **通信ポート定数の最大範囲を指定します。 '''コメント''' 直接 (ローカル) 接続またはモデム接続で使用されるポートの名前を取得 (またはセット) するかどうかを指定するために {{goto CmGetComPort,CmGetComPort()}} (または {{goto CmSetComPort,CmSetComPort()}}|C/C++ Sync Suite Reference601/11-3) にこれらの値の 1 つを渡します。これらの値はどの HotSync マネージャ コンフィグレーション エントリが読み込みまたは書き込みを行うかを指定します。 これらの値はシステム全体に対してセットされるのであり、Windows ユーザごとにセットされるのではないということに注意してください。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmGetComPort,CmGetComPort()}}, {{goto CmSetComPort,CmSetComPort()|C/C++ Sync Suite Reference601/11-3}} !{{anchor Conduit Manager Versions}}コンジット マネージャ バージョン {{goto top,^TOP^}} '''目的''' {{goto CmGetLibVersion,CmGetLibVersion()|C/C++ Sync Suite Reference601/11-2}} が返す可能性があるコンジット マネージャ バージョン番号を定義します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''定数''' *{{span style='color:blue;font-family:monospace;',#define CM_INITIAL_LIB_VERSION 0x0001}} **コンジット マネージャ バージョン 1 によって返される値。 *{{span style='color:blue;font-family:monospace;',#define CM_UPDATE_1 0x0002}} **コンジット マネージャ バージョン 2 によって返される値。 *{{span style='color:blue;font-family:monospace;',#define CM_UPDATE_2 0x0003}} **コンジット マネージャ バージョン 3 によって返される値。このバージョンは HotSync マネージャ バージョン 6.0 以降とともに出荷されます。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmGetLibVersion,CmGetLibVersion()|C/C++ Sync Suite Reference601/11-2}} !{{anchor Miscellaneous Constants}}その他の定数 {{goto top,^TOP^}} '''目的''' コンジット マネージャで使用されるその他の定数を定義します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''定数''' *{{span style='color:blue;font-family:monospace;',#define CM_CREATOR_ID_SIZE 8}} **クリエイタ ID のサイズ ({{span style='color:blue;font-family:monospace;',char}} の数)。この値はいくつかのデータ構造体の中でクリエイタ ID を保存するための文字配列のサイズを定義するために使用されます。 *{{span style='color:blue;font-family:monospace;',#define CONDUIT_VERSION 100}} **コンジット マネージャの {{goto CmConduitType,CmConduitType}} 構造体の現在のバージョン。この値は {{goto CmGetLibVersion,CmGetLibVersion()|C/C++ Sync Suite Reference601/11-2}} によって返されるコンジット マネージャのバージョンではありません。 *{{span style='color:blue;font-family:monospace;',#define CM_CONDUIT_BUFFER_OFFSET sizeof(CmConduitType)}} **{{goto CmConduitType,CmConduitType}} 構造体の開始点からのオフセットを定義します。 *{{span style='color:blue;font-family:monospace;',#define CM_MIN_CONDUITTYPE_SIZE sizeof(CmConduitType)}} **{{goto CmConduitType,CmConduitType}} 構造体の最小サイズをを定義します。 *{{span style='color:blue;font-family:monospace;',#define FILEINSTALLTYPE_SIZE sizeof(FileInstallType)}} **{{goto FileInstallType,FileInstallType|C/C++ Sync Suite Reference601/12}} 構造体のサイズを定義します。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて !!{{anchor Conduit Manager Functions}}コンジット マネージャ関数 {{goto top,^TOP^}} この節では、あなたがコンジットを登録して {{goto configuration entries,コンフィグレーション エントリ|Introduction to Conduit Development601/Glossary}} から情報を取得することを可能にする関数について説明します。 ,関数,説明 ,"{{goto CmConvertCreatorIDToString,CmConvertCreatorIDToString()}}","クリエイタ ID を {{span style='color:blue;font-family:monospace;',DWORD}} から文字列に変換します。" ,"{{goto CmConvertStringToCreatorID,CmConvertStringToCreatorID()}}","クリエイタ ID を文字列から {{span style='color:blue;font-family:monospace;',DWORD}} に変換します。" ,"{{goto CmGetBackupConduit,CmGetBackupConduit()}}",現在の Windows ユーザのためのバックアップ コンジットのパスまたはファイル名を取得します。 ,"{{goto CmGetComPort,CmGetComPort()}}",HotSync マネージャがデスクトップ コンピュータ上の指定された接続タイプのために使用する COM ポートの名前を取得します。 ,"{{goto CmGetConduitByCreator,CmGetConduitByCreator()}}",与えられたコンジットのクリエイタ ID から現在の Windows ユーザのために登録されたコンジットについての情報を取得します。 ,"{{goto CmGetConduitByIndex,CmGetConduitByIndex()}}",与えられたコンジットのインデックスから現在の Windows ユーザのために登録されたコンジットについての情報を取得します。 ,"{{goto CmGetConduitCount,CmGetConduitCount()}}",現在の Windows ユーザのために HotSync マネージャに登録されているコンジットの数を返します。 ,"{{goto CmGetConduitCreatorID,CmGetConduitCreatorID()}}",現在の Windows ユーザのために登録されたコンジットのクリエイタ ID を取得します。 ,"{{goto CmGetCorePath,CmGetCorePath()}}",現在の Windows ユーザのための HotSync ユーザのディレクトリのパスを取得します。 ,"{{goto CmGetCreatorArgument,CmGetCreatorArgument()}}","(使用を推奨されなくなりました) 指定されたコンジットのための {{span style='color:blue;font-family:monospace;',Arguments}} コンフィグレーション エントリの値を取得します。" ,"{{goto CmGetCreatorDirectory,CmGetCreatorDirectory()}}",ユーザ登録コンジットがそれのユーザ データを保存するディレクトリの名前を取得します。 ,"{{goto CmGetCreatorFile,CmGetCreatorFile()}}",ユーザ登録コンジットのためのデータ ファイルの名前を取得します。 ,"{{goto CmGetCreatorIDList,CmGetCreatorIDList()}}",現在の Windows ユーザのために登録されているすべてのコンジットのクリエイタ ID のリストを取得します。 ,"{{goto CmGetCreatorInfo,CmGetCreatorInfo()}}",(使用を推奨されなくなりました) ユーザ登録コンジットに関連付けられている文字列を取得します。 ,"{{goto CmGetCreatorIntegrate,CmGetCreatorIntegrate()}}","(使用を推奨されなくなりました) 指定されたコンジットのための {{span style='color:blue;font-family:monospace;',Integrate}} コンフィグレーション エントリの値を取得します。" ,"{{goto CmGetCreatorModule,CmGetCreatorModule()}}","(使用を推奨されなくなりました) 指定されたコンジットのための {{span style='color:blue;font-family:monospace;',Module}} コンフィグレーション エントリの値を取得します。" ,"{{goto CmGetCreatorName,CmGetCreatorName()}}",ユーザ登録コンジットのファイル名を取得します。 ,"{{goto CmGetCreatorPriority,CmGetCreatorPriority()}}",ユーザ登録コンジットの実行優先順位を取得します。 ,"{{goto CmGetCreatorRemote,CmGetCreatorRemote()}}",ユーザ登録コンジットに関連付けされているハンドヘルド上のデータベースの名前を取得します。 ,"{{goto CmGetCreatorTitle,CmGetCreatorTitle()}}",ユーザ登録コンジットのディスプレイ名を取得します。 ,"{{goto CmGetCreatorType,CmGetCreatorType()}}",(使用を推奨されなくなりました) 指定されたコンジットのタイプ - コンポーネントまたはアプリケーション - を返します。 ,"{{goto CmGetCreatorUser,CmGetCreatorUser()}}","(使用を推奨されなくなりました) 指定されたコンジットの {{span style='color:blue;font-family:monospace;',Username}} コンフィグレーション エントリの値を取得します。" ,"{{goto CmGetCreatorValueDword,CmGetCreatorValueDword()}}","ユーザ登録コンジットの {{span style='color:blue;font-family:monospace;',DWORD}} コンフィグレーション エントリ値を取得します。" ,"{{goto CmGetCreatorValueString,CmGetCreatorValueString()}}",ユーザ登録コンジットの文字列コンフィグレーション エントリ値を取得します。 ,"{{goto CmGetDiscoveryInfoByIndex,CmGetDiscoveryInfoByIndex()}}",HotSync マネージャがどのようにユーザ登録コンジットを見つけ出すのかについての情報を取得します。 ,"{{goto CmGetHotSyncExecPath,CmGetHotSyncExecPath()|C/C++ Sync Suite Reference601/11-2}}","(使用を推奨されなくなりました) デスクトップ コンピュータ上の HotSync マネージャ実行ファイルのパスとファイル名を取得します。(サポート DLL のパスを取得するには {{span style='color:blue;font-family:monospace;',HotSync.exe}} ファイル名を取り除きます。)" ,"{{goto CmGetLibVersion,CmGetLibVersion()|C/C++ Sync Suite Reference601/11-2}}",現在ロードされている DLL からコンジット マネージャ API のバージョン番号を返します。 ,"{{goto CmGetNotifierDll,CmGetNotifierDll()|C/C++ Sync Suite Reference601/11-2}}",(使用を推奨されなくなりました) 通知機能 DLL の名前を取得します。 ,"{{goto CmGetPCIdentifier,CmGetPCIdentifier()|C/C++ Sync Suite Reference601/11-2}}",デスクトップ コンピュータ上の現在の Windows ユーザの固有識別子を取得します。 ,"{{goto CmGetSystemBackupConduit,CmGetSystemBackupConduit()|C/C++ Sync Suite Reference601/11-2}}",システムのためのバックアップ コンジットとして登録されているコンジットの名前を取得します。 ,"{{goto CmGetSystemConduitByCreator,CmGetSystemConduitByCreator()|C/C++ Sync Suite Reference601/11-2}}",与えられたコンジットのクリエイタ ID からシステムのために登録されているコンジットについての情報を取得します。 ,"{{goto CmGetSystemConduitByIndex,CmGetSystemConduitByIndex()|C/C++ Sync Suite Reference601/11-2}}",与えられたコンジットのインデックスからシステムのために登録されているコンジットについての情報を取得します。 ,"{{goto CmGetSystemConduitCount,CmGetSystemConduitCount()|C/C++ Sync Suite Reference601/11-2}}",システムのために HotSync マネージャに登録されているコンジットの数を返します。 ,"{{goto CmGetSystemConduitCreatorID,CmGetSystemConduitCreatorID()|C/C++ Sync Suite Reference601/11-2}}",システムのために登録されているコンジットのクリエイタ ID を取得します。 ,"{{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}}",システムのために登録されているすべてのコンジットのクリエイタ ID のリストを取得します。 ,"{{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}}","システム登録コンジットのための {{span style='color:blue;font-family:monospace;',DWORD}} コンフィグレーション エントリ値を取得します。" ,"{{goto CmGetSystemCreatorValueString,CmGetSystemCreatorValueString()|C/C++ Sync Suite Reference601/11-2}}",システム登録コンジットのための文字列コンフィグレーション エントリ値を取得します。 ,"{{goto CmGetSystemDiscoveryInfoByIndex,CmGetSystemDiscoveryInfoByIndex()|C/C++ Sync Suite Reference601/11-2}}",HotSync マネージャがシステム登録コンジットを発見する方法を取得します。 ,"{{goto CmGetSystemHotSyncExecPath,CmGetSystemHotSyncExecPath()|C/C++ Sync Suite Reference601/11-2}}","デスクトップ コンピュータ上の HotSync マネージャの実行形式ファイルのパスとファイル名を取得します。(サポート DLL のパスを取得するにはファイル名 {{span style='color:blue;font-family:monospace;',HotSync.exe}} を取り除きます。)" ,"{{goto CmInstallConduit,CmInstallConduit()|C/C++ Sync Suite Reference601/11-2}}","コンジットを現在の Windows ユーザのために HotSync マネージャに登録します。{{span style='color:blue;font-family:monospace;',CmConduitType}} 構造体を使用します。" ,"{{goto CmInstallConduitByStruct,CmInstallConduitByStruct()|C/C++ Sync Suite Reference601/11-2}}","コンジットを現在の Windows ユーザのために HotSync マネージャに登録します。{{span style='color:blue;font-family:monospace;',CmConduitType2}} 構造体を使用します。" ,"{{goto CmInstallCreator,CmInstallCreator()|C/C++ Sync Suite Reference601/11-2}}","新しいコンジット クリエイタ ID を現在の Windows ユーザのために HotSync マネージャに登録します (登録を完了するには {{span style='color:blue;font-family:monospace;',CmSetCreator...()|C/C++ Sync Suite Reference601/11-2}} 関数を呼び出すことが必要です)。" ,"{{goto CmInstallSystemConduitByStruct,CmInstallSystemConduitByStruct()|C/C++ Sync Suite Reference601/11-2}}","コンジットをシステムのために HotSync マネージャに登録します。{{span style='color:blue;font-family:monospace;',CmConduitType2}} 構造体を使用します。" ,"{{goto CmInstallSystemCreator,CmInstallSystemCreator()|C/C++ Sync Suite Reference601/11-2}}","新しいコンジット クリエイタ ID を現在のシステムのために HotSync マネージャに登録します (登録を完了するには {{span style='color:blue;font-family:monospace;',CmSetSystemCreator...()|C/C++ Sync Suite Reference601/11-2}} 関数を呼び出すことが必要です)。" ,"{{goto CmIsCurrentUserAdmin,CmIsCurrentUserAdmin()|C/C++ Sync Suite Reference601/11-2}}",現在のユーザが Windows 管理者権限を持っているかどうかを決定します。 ,"{{goto CmRemoveConduitByCreatorID,CmRemoveConduitByCreatorID()|C/C++ Sync Suite Reference601/11-2}}",与えられたコンジットのクリエイタ ID によって現在の Windows ユーザのために登録されているコンジットの登録を解除します。 ,"{{goto CmRemoveConduitByIndex,CmRemoveConduitByIndex()|C/C++ Sync Suite Reference601/11-2}}",与えられたコンジットのインデックスによって現在の Windows ユーザのために登録されているコンジットの登録を解除します。 ,"{{goto CmRemoveSystemConduitByCreatorID,CmRemoveSystemConduitByCreatorID()|C/C++ Sync Suite Reference601/11-2}}",与えられたコンジットのクリエイタ ID によってシステムのために登録されているコンジットの登録を解除します。 ,"{{goto CmRemoveSystemConduitByIndex,CmRemoveSystemConduitByIndex()|C/C++ Sync Suite Reference601/11-2}}",与えられたコンジットのインデックスによってシステムのために登録されているコンジットの登録を解除します。 ,"{{goto CmRestoreHotSyncSettings,CmRestoreHotSyncSettings()|C/C++ Sync Suite Reference601/11-2}}",(使用を推奨されなくなりました) HotSync マネージャ コンフィグレーション エントリ設定をデフォルト値に戻します。 ,"{{goto CmSetBackupConduit,CmSetBackupConduit()|C/C++ Sync Suite Reference601/11-3}}",現在の Windows ユーザのためのバックアップ コンジットのパスまたはファイル名をセットします。 ,"{{goto CmSetComPort,CmSetComPort()|C/C++ Sync Suite Reference601/11-3}}",HotSync マネージャがデスクトップ コンピュータの指定されたタイプの接続のために使用する COM ポートの名前をセットします。 ,"{{goto CmSetCorePath,CmSetCorePath()|C/C++ Sync Suite Reference601/11-3}}",(使用を推奨されなくなりました) 現在の Windows ユーザのための HotSync ユーザ ディレクトリのパスをセットします。 ,"{{goto CmSetCreatorArgument,CmSetCreatorArgument()|C/C++ Sync Suite Reference601/11-3}}","(使用を推奨されなくなりました) 指定されたコンジットのための {{span style='color:blue;font-family:monospace;',Arguments}} コンフィグレーション エントリの値をセットします。" ,"{{goto CmSetCreatorDirectory,CmSetCreatorDirectory()|C/C++ Sync Suite Reference601/11-3}}",ユーザ登録コンジットがそのコンジットのユーザ データを保存するディレクトリの名前をセットします。 ,"{{goto CmSetCreatorFile,CmSetCreatorFile()|C/C++ Sync Suite Reference601/11-3}}",ユーザ登録コンジットのためのデータ ファイルの名前をセットします。 ,"{{goto CmSetCreatorInfo,CmSetCreatorInfo()|C/C++ Sync Suite Reference601/11-3}}",(使用を推奨されなくなりました) ユーザ登録コンジットに関連付けされる文字列をセットします。 ,"{{goto CmSetCreatorIntegrate,CmSetCreatorIntegrate()|C/C++ Sync Suite Reference601/11-3}}","(使用を推奨されなくなりました) 指定されたコンジットのための {{span style='color:blue;font-family:monospace;',Integrate}} コンフィグレーション エントリの値をセットします。" ,"{{goto CmSetCreatorModule,CmSetCreatorModule()|C/C++ Sync Suite Reference601/11-3}}","(使用を推奨されなくなりました) 指定されたコンジットのための {{span style='color:blue;font-family:monospace;',Module}} コンフィグレーション エントリの値をセットします。" ,"{{goto CmSetCreatorName,CmSetCreatorName()|C/C++ Sync Suite Reference601/11-3}}",ユーザ登録コンジットのファイル名をセットします。 ,"{{goto CmSetCreatorPriority,CmSetCreatorPriority()|C/C++ Sync Suite Reference601/11-3}}",ユーザ登録コンジットのための実行優先順位をセットします。 ,"{{goto CmSetCreatorRemote,CmSetCreatorRemote()|C/C++ Sync Suite Reference601/11-3}}",ユーザ登録コンジットに関連付けされるハンドヘルド上のデータベースの名前をセットします。 ,"{{goto CmSetCreatorTitle,CmSetCreatorTitle()|C/C++ Sync Suite Reference601/11-3}}",ユーザ登録コンジットの表示名をセットします。 ,"{{goto CmSetCreatorUser,CmSetCreatorUser()|C/C++ Sync Suite Reference601/11-3}}","(使用を推奨されなくなりました) 指定されたコンジットのための {{span style='color:blue;font-family:monospace;',Username}} コンフィグレーション エントリの値をセットします。" ,"{{goto CmSetCreatorValueDword,CmSetCreatorValueDword()|C/C++ Sync Suite Reference601/11-3}}","ユーザ登録コンジットのための {{span style='color:blue;font-family:monospace;',DWORD}} コンフィグレーション エントリの値をセットします。" ,"{{goto CmSetCreatorValueString,CmSetCreatorValueString()|C/C++ Sync Suite Reference601/11-3}}",ユーザ登録コンジットのための文字列コンフィグレーション エントリの値をセットします。 ,"{{goto CmSetHotSyncExecPath,CmSetHotSyncExecPath()|C/C++ Sync Suite Reference601/11-3}}",(使用を推奨されなくなりました) 現在の Windows ユーザのための HotSync マネージャ実行形式ファイルのパスとファイル名をセットします。 ,"{{goto CmSetNotifierDll,CmSetNotifierDll()|C/C++ Sync Suite Reference601/11-3}}",(使用を推奨されなくなりました) 通知 DLL の名前をセットします。 ,"{{goto CmSetPCIdentifier,CmSetPCIdentifier()|C/C++ Sync Suite Reference601/11-3}}",(使用を推奨されなくなりました) デスクトップ コンピュータ上の現在の Windows ユーザのための固有識別子をセットします。 ,"{{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}}","システム登録コンジットのための {{span style='color:blue;font-family:monospace;',DWORD}} コンフィグレーション エントリの値をセットします。" ,"{{goto CmSetSystemCreatorValueString,CmSetSystemCreatorValueString()|C/C++ Sync Suite Reference601/11-3}}",システム登録コンジットのための文字列コンフィグレーション エントリの値をセットします。 ,"{{goto FmDisableCurrentUserConduitByIndex,FmDisableCurrentUserConduitByIndex()|C/C++ Sync Suite Reference601/11-3}}","与えれられたインデックスで現在の Windows ユーザの {{span style='color:blue;font-family:monospace;',Conduits}} フォルダの中にあるコンジットを使用不可にします。" ,"{{goto FmDisableCurrentUserConduitByPath,FmDisableCurrentUserConduitByPath()|C/C++ Sync Suite Reference601/11-3}}","与えれられたコンジットのパスまたはファイル名で現在の Windows ユーザの {{span style='color:blue;font-family:monospace;',Conduits}} フォルダの中にあるコンジットを使用不可にします。" ,"{{goto FmDisableSystemConduitByIndex,FmDisableSystemConduitByIndex()|C/C++ Sync Suite Reference601/11-3}}","与えれられたインデックスでシステムの {{span style='color:blue;font-family:monospace;',Conduits}} フォルダの中にあるコンジットを使用不可にします。" ,"{{goto FmDisableSystemConduitByPath,FmDisableSystemConduitByPath()|C/C++ Sync Suite Reference601/11-3}}","与えれられたコンジットのパスまたはファイル名でシステムの {{span style='color:blue;font-family:monospace;',Conduits}} フォルダの中にあるコンジットを使用不可にします。" ,"{{goto FmEnableCurrentUserConduitByPath,FmEnableCurrentUserConduitByPath()|C/C++ Sync Suite Reference601/11-3}}","与えられたコンジットのパスまたはファイル名で現在の Windows ユーザの {{span style='color:blue;font-family:monospace;',Disabled}} フォルダの中にあるコンジットを使用可能にします。" ,"{{goto FmEnableSystemConduitByPath,FmEnableSystemConduitByPath()|C/C++ Sync Suite Reference601/11-3}}","与えられたコンジットのパスまたはファイル名でシステムの {{span style='color:blue;font-family:monospace;',Disabled}} フォルダの中にあるコンジットを使用可能にします。" ,"{{goto FmGetCurrentUserConduitByIndex,FmGetCurrentUserConduitByIndex()|C/C++ Sync Suite Reference601/11-3}}",与えられたコンジットのインデックスで現在の Windows ユーザのために登録されているフォルダ ベース コンジットについての情報を取得します。 ,"{{goto FmGetCurrentUserConduitCount,FmGetCurrentUserConduitCount()|C/C++ Sync Suite Reference601/11-3}}",現在の Windows ユーザのために HotSync マネージャに登録されているフォルダ ベース コンジットの数を返します。 ,"{{goto FmGetCurrentUserConduitFolder,FmGetCurrentUserConduitFolder()|C/C++ Sync Suite Reference601/11-3}}","現在の Windows ユーザの {{span style='color:blue;font-family:monospace;',Conduits}} フォルダのパスを取得します。" ,"{{goto FmGetCurrentUserDisabledConduitFolder,FmGetCurrentUserDisabledConduitFolder()|C/C++ Sync Suite Reference601/11-3}}","現在の Windows ユーザの {{span style='color:blue;font-family:monospace;',Disabled}} フォルダのパスを取得します。" ,"{{goto FmGetSystemConduitByIndex,FmGetSystemConduitByIndex()|C/C++ Sync Suite Reference601/11-3}}",与えられたコンジットのインデックスでシステムのために登録されているフォルダ ベース コンジットについての情報を取得します。 ,"{{goto FmGetSystemConduitCount,FmGetSystemConduitCount()|C/C++ Sync Suite Reference601/11-3}}",システムのために HotSync マネージャに登録されているフォルダ ベース コンジットの数を返します。 ,"{{goto FmGetSystemConduitFolder,FmGetSystemConduitFolder()|C/C++ Sync Suite Reference601/11-3}}","システムの {{span style='color:blue;font-family:monospace;',Conduits}} フォルダのパスを取得します。" ,"{{goto FmGetSystemDisabledConduitFolder,FmGetSystemDisabledConduitFolder()|C/C++ Sync Suite Reference601/11-3}}","システムの {{span style='color:blue;font-family:monospace;',Disabled}} フォルダのパスを取得します。" !{{anchor CmConvertCreatorIDToString}}CmConvertCreatorIDToString 関数 {{goto top,^TOP^}} '''目的''' クリエイタ ID を {{span style='color:blue;font-family:monospace;',DWORD}} から文字列に変換します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmConvertCreatorIDToString ( DWORD dwID, TCHAR *pString, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ dwID}} **{{span style='color:blue;font-family:monospace;',DWORD}} のクリエイタ ID。 *{{span style='color:blue;font-family:monospace;',← pString}} **文字バッファへのポインタ。返り時には、これは文字列のクリエイタ ID を保持しています。 *{{span style='color:blue;font-family:monospace;',←→ piSize}} **{{span style='color:blue;font-family:monospace;',pString}} によって参照される文字バッファのサイズを指定する整数値へのポインタ。返り時には、これは実際のサイズ - クリエイタ ID 文字列の {{span style='color:blue;font-family:monospace;',TCHAR}} 数 - になります。文字列バッファが小さすぎるためにこの関数が失敗した場合、返り時の {{span style='color:blue;font-family:monospace;',piSize}} の値はバッファに必要とされるサイズです。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_BUFFER_TOO_SMALL}} **あなたが提供したバッファのサイズが文字列を保持するには小さすぎます。そのため、この関数は必要とされるサイズを {{span style='color:blue;font-family:monospace;',piSize}} パラメータに返します。 *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} **指定されたクリエイタ ID は有効なクリエイタ ID ではありません。 *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} **指定されたポインタは有効なポインタではありません。 すべてのコンジット マネージャ エラー コードについての説明は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmConvertStringToCreatorID,CmConvertStringToCreatorID()}} !{{anchor CmConvertStringToCreatorID}}CmConvertStringToCreatorID 関数 {{goto top,^TOP^}} '''目的''' クリエイタ ID を文字列から {{span style='color:blue;font-family:monospace;',DWORD}} に変換します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmConvertStringToCreatorID ( const TCHAR *pString, DWORD *pdwID ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pString}} **文字列のクリエイタ ID。これは 4 文字のクリエイタ ID でなければなりません。 *{{span style='color:blue;font-family:monospace;',← pdwID}} **{{span style='color:blue;font-family:monospace;',DWORD}} に変換されたクリエイタ ID。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} **指定されたクリエイタ ID は有効なクリエイタ ID ではありません。 *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} **指定されたポインタは有効なポインタではありません。 すべてのコンジット マネージャ エラー コードについての説明は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' 他のコンジット マネージャ関数は文字列ではなく {{span style='color:blue;font-family:monospace;',DWORD}} 値のクリエイタ ID をとります。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmConvertCreatorIDToString,CmConvertCreatorIDToString()}} !{{anchor CmGetBackupConduit}}CmGetBackupConduit 関数 {{goto top,^TOP^}} '''目的''' 現在の Windows ユーザのためのバックアップ コンジットのパスまたはファイル名を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetBackupConduit ( TCHAR *pConduit, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',← pConduit}} **文字バッファへのポインタ。返り時には、これはバックアップ コンジットとして使用されるコンジットのフル パスまたはファイル名を保持します。 *{{span style='color:blue;font-family:monospace;',←→ piSize}} **{{span style='color:blue;font-family:monospace;',pConduit}} によって参照される文字バッファのサイズを指定する整数値へのポインタ。返り時には、これはバックアップ コンジット名文字列の実際のサイズ - {{span style='color:blue;font-family:monospace;',TCHAR}} の数 - になります。文字列バッファが小さすぎるためにこの関数が失敗した場合、返り時の {{span style='color:blue;font-family:monospace;',piSize}} の値はバッファに必要とされるサイズになります。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} **コンジット コンフィグレーション エントリにアクセスすることができません。 *{{span style='color:blue;font-family:monospace;',ERR_BUFFER_TOO_SMALL}} **あなたが提供したバッファのサイズは文字列を保持するには小さすぎます。そのため、この関数は必要とされるサイズを {{span style='color:blue;font-family:monospace;',piSize}} パラメータに返します。 *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} **指定されたポインタは有効なポインタではありません。 すべてのコンジット マネージャ エラー コードについての説明は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' この関数は現在の Windows ユーザのために HotSync マネージャによって使用される {{goto HotSync Manager\BackupConduit 3,HotSync Manager\BackupConduit|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値を取得します。システムのために登録されているバックアップ コンジットのパスまたはファイル名を取得するには、{{goto CmGetSystemBackupConduit,CmGetSystemBackupConduit()|C/C++ Sync Suite Reference601/11-2}} を使用します。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto HotSync Manager\BackupConduit 3,HotSync Manager\BackupConduit|Introduction to Conduit Development601/A}}, {{goto CmSetBackupConduit,CmSetBackupConduit()|C/C++ Sync Suite Reference601/11-3}}, {{goto CmGetSystemBackupConduit,CmGetSystemBackupConduit()|C/C++ Sync Suite Reference601/11-2}} !{{anchor CmGetComPort}}CmGetComPort 関数 {{goto top,^TOP^}} '''目的''' HotSync マネージャがデスクトップ コンピュータ上の指定された接続タイプのために使用する COM ポートの名前を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetComPort ( int iType, TCHAR *pPort, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ iType}} **取得する COM ポートの接続タイプ。あなたは {{goto Communications Ports,「通信ポート」}} で宣言されている値の 1 つを指定しなければなりません。 *{{span style='color:blue;font-family:monospace;',← pPort}} **文字バッファ。返り時には、これはポート名 - 例えば、"COM1" - を保持します。 *{{span style='color:blue;font-family:monospace;',←→ piSize}} **{{span style='color:blue;font-family:monospace;',pPort}} パラメータによって参照されるバッファのサイズ - {{span style='color:blue;font-family:monospace;',TCHAR}} の数 - を指定します。返り時には、これはポート名文字列の実際のサイズ - {{span style='color:blue;font-family:monospace;',TCHAR}} の数 - になります。文字列バッファが小さすぎるためにこの関数が失敗した場合、返り時の {{span style='color:blue;font-family:monospace;',piSize}} の値はバッファに必要とされるサイズになります。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} **コンジット コンフィグレーション エントリにアクセスすることができません。 *{{span style='color:blue;font-family:monospace;',ERR_BUFFER_TOO_SMALL}} **あなたが提供したバッファのサイズは文字列を保持するには小さすぎます。そのため、この関数は必要とされるサイズを {{span style='color:blue;font-family:monospace;',piSize}} パラメータに返します。 *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} **指定されたポインタは有効なポインタではありません。 *{{span style='color:blue;font-family:monospace;',ERR_INVALID_COM_PORT_TYPE}} **指定された通信ポート タイプは有効ではありません。あなたは {{goto Communications Ports,「通信ポート」}} で宣言されている値の 1 つを使用しなければなりません。 すべてのコンジット マネージャ エラー コードについての説明は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' この関数はあなたが {{span style='color:blue;font-family:monospace;',iType}} パラメータに指定した値に基づいてコンフィグレーション エントリの HotSync マネージャ部分から {{goto HotSync Manager\ModemComPort 3,HotSync Manager\ModemComPort|Introduction to Conduit Development601/A}} エントリか {{goto HotSync Manager\DirectComPort 3,HotSync Manager\DirectComPort|Introduction to Conduit Development601/A}} エントリのどちらかを取得します。これらの値は現在の Windows ユーザに対してのみセットされるということに注意してください。これらに相当するシステムに対する設定はありません。HotSync マネージャは新しい Windows ユーザに対してそれぞれデフォルト値をセットします。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto HotSync Manager\ModemComPort 3,HotSync Manager\ModemComPort|Introduction to Conduit Development601/A}}, {{goto HotSync Manager\DirectComPort 3,HotSync Manager\DirectComPort|Introduction to Conduit Development601/A}} !{{anchor CmGetConduitByCreator}}CmGetConduitByCreator 関数 {{goto top,^TOP^}} '''目的''' 与えられたコンジットのクリエイタ ID から現在の Windows ユーザのために登録されたコンジットについての情報を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetConduitByCreator ( const char *pCreatorID, HANDLE *hStruct ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreatorID}} **文字列で提供するコンジットのクリエイタ ID。 *{{span style='color:blue;font-family:monospace;',← hStruct}} **ハンドルへのポインタ。この関数は {{goto CmConduitType,CmConduitType}} 構造体のために記憶装置を割り当て、データをその構造体に保存し、ハンドルを返します。記憶装置の割り当てを解除する責任はあなたにあります。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_NO_MEMORY}} **リクエストされた操作を実行するにはメモリが不足しています。 *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} **コンフィグレーション エントリにアクセスすることができません。 *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} **指定されたクリエイタ ID は有効なクリエイタ ID ではありません。 *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} **指定されたポインタは有効なポインタではありません。 すべてのコンジット マネージャ エラー コードについての説明は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' この関数は記憶装置を割り当て、その記憶装置のハンドルを返します。あなたは処理を終了した後にそのハンドルの割り当てを解除しなければなりません。 コンジット マネージャは {{span style='color:blue;font-family:monospace;',GMEM_MOVEABLE}} フラグで {{span style='color:blue;font-family:monospace;',GlobalAlloc()}} 関数を呼び出すことによって {{span style='color:blue;font-family:monospace;',hStruct}} ハンドルに割り当てを行うということに注意してください。ハンドルをポインタに変換するには、あなたが {{span style='color:blue;font-family:monospace;',GlobalLock()}} 関数と {{span style='color:blue;font-family:monospace;',GlobalUnlock()}} 関数を使用する必要があります。例えば以下のように: CmConduitType *pConduit = (CmConduitType*) GlobalLock(*hStruct); GlobalUnlock(*hStruct); この関数は現在の Windows ユーザのために登録されているコンジットについての情報を取得します。システムのために登録されているコンジットに対するこの情報 (訳者: {{goto CmConduitType,CmConduitType}} 構造体) を取得するには、{{goto CmGetSystemConduitByCreator,CmGetSystemConduitByCreator()|C/C++ Sync Suite Reference601/11-2}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmConduitType,CmConduitType}}, {{goto CmInstallConduitByStruct,CmInstallConduitByStruct()|C/C++ Sync Suite Reference601/11-2}}, {{goto CmGetConduitByIndex,CmGetConduitByIndex()}}, {{goto CmGetSystemConduitByCreator,CmGetSystemConduitByCreator()|C/C++ Sync Suite Reference601/11-2}} !{{anchor CmGetConduitByIndex}}CmGetConduitByIndex 関数 {{goto top,^TOP^}} '''目的''' 与えられたコンジットのインデックスから現在の Windows ユーザのために登録されたコンジットについての情報を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetConduitByIndex ( int iIndex, CmConduitType2 &sConduitInfo ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ iIndex}} **現在の Windows ユーザのために登録されているコンジットの 0 ベース インデックス。インデックスの最大値を決定するには {{goto CmGetConduitCount,CmGetConduitCount()}} を呼び出します。 *{{span style='color:blue;font-family:monospace;',← sConduitInfo}} **指定されたコンジットについて説明する {{goto CmConduitType2,CmConduitType2}} 構造体への参照。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_INDEX_OUT_OF_RANGE}} **指定されたインデックス値は範囲外です。 すべてのコンジット マネージャ エラー コードについての説明は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' この関数は現在の Windows ユーザのために登録されているコンジットについての情報を取得します。システムのために登録されているコンジットに対するこの情報 (訳者: {{goto CmConduitType2,CmConduitType2}} 構造体) を取得するには、{{goto CmGetSystemConduitByIndex,CmGetSystemConduitByIndex()|C/C++ Sync Suite Reference601/11-2}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmConduitType2,CmConduitType2}}, {{goto CmInstallConduitByStruct,CmInstallConduitByStruct()|C/C++ Sync Suite Reference601/11-2}}, {{goto CmGetConduitCount,CmGetConduitCount()}}, {{goto CmGetSystemConduitByIndex,CmGetSystemConduitByIndex()|C/C++ Sync Suite Reference601/11-2}}, {{goto CmGetConduitByCreator,CmGetConduitByCreator()}} !{{anchor CmGetConduitCount}}CmGetConduitCount 関数 {{goto top,^TOP^}} '''目的''' 現在の Windows ユーザのために HotSync マネージャに登録されているコンジットの数を返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetConduitCount ( void ) '''パラメータ''' ありません。 '''返り値''' 成功した場合、登録されているコンジットの数を返します。 失敗した場合、以下の非 0 のエラー コード値を返します: *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} すべてのコンジット マネージャ エラー コードについての説明は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' 返されるコンジットは現在の Windows ユーザのために登録されているコンジットすべてです。この数にはユーザの {{span style='color:blue;font-family:monospace;',Conduits}} フォルダに置かれることによって登録されたコンジット (フォルダ登録) とコンフィグレーション エントリによって登録されたコンジット (通常通りの登録) が含まれます。この数にはバックアップ コンジット、インストール コンジットを含まれず、システム登録コンジットも含まれません。システムのために登録されているコンジットに対するこの情報 (訳者: 登録されているコンジット数) を取得するには、{{goto CmGetSystemConduitCount,CmGetSystemConduitCount()|C/C++ Sync Suite Reference601/11-2}} を呼び出します。 あなたはこの数を使って有効なインデックス値の範囲を決定することができ、それを {{goto CmGetConduitByIndex,CmGetConduitByIndex()}} で使用することができます。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmGetSystemConduitCount,CmGetSystemConduitCount()|C/C++ Sync Suite Reference601/11-2}}, {{goto CmGetConduitByIndex,CmGetConduitByIndex()}} !{{anchor CmGetConduitCreatorID}}CmGetConduitCreatorID 関数 {{goto top,^TOP^}} '''目的''' 現在の Windows ユーザのために登録されたコンジットのクリエイタ ID を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetConduitCreatorID ( int iIndex, char *pCreatorID, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ iIndex}} **現在の Windows ユーザのために登録されいてるコンジットの 0 ベースのインデックス。インデックスの最大値を決定するには {{goto CmGetConduitCount,CmGetConduitCount()}} を呼び出します。 *{{span style='color:blue;font-family:monospace;',← pCreatorID}} **文字バッファ。返り時には、これはクリエイタ ID 文字列を保持しています。 *{{span style='color:blue;font-family:monospace;',←→ piSize}} **{{span style='color:blue;font-family:monospace;',pCreatorID}} パラメータによって参照されるバッファのサイズ ({{span style='color:blue;font-family:monospace;',char}} の数) を指定する整数へのポインタ。返り時には、これはクリエイタ ID 文字列の実際のサイズ ({{span style='color:blue;font-family:monospace;',char}} の数) になります。文字列バッファが小さすぎるためにこの関数が失敗した場合、返り時の {{span style='color:blue;font-family:monospace;',piSize}} の値はバッファに必要とされるサイズになります。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_BUFFER_TOO_SMALL}} **あなたが提供したバッファのサイズは文字列を保持するには小さすぎます。そのため、この関数は必要とされるサイズを {{span style='color:blue;font-family:monospace;',piSize}} パラメータに返します。 すべてのコンジット マネージャ エラー コードについての説明は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' コンフィグレーション エントリの中で最初に定義されているコンジットを指定するには 0 を指定します。その後に続く各コンジットに対してはインデックス値を +1 します。 この関数は現在の Windows ユーザのために登録されているコンジットについての情報を取得します。システムのために登録されているコンジットに対してこの情報 (訳者: クリエイタ ID) を取得するには、{{goto CmGetSystemConduitCreatorID,CmGetSystemConduitCreatorID()|C/C++ Sync Suite Reference601/11-2}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmGetConduitCount,CmGetConduitCount()}}, {{goto CmGetSystemConduitCreatorID,CmGetSystemConduitCreatorID()|C/C++ Sync Suite Reference601/11-2}}, {{goto CmInstallConduitByStruct,CmInstallConduitByStruct()|C/C++ Sync Suite Reference601/11-2}} !{{anchor CmGetCorePath}}CmGetCorePath 関数 {{goto top,^TOP^}} '''目的''' 現在の Windows ユーザのための HotSync ユーザのディレクトリのパスを取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetCorePath ( TCHAR *pPath, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',← pPath}} **文字バッファへのポインタ。返り時には、これはパスを保持しています。 *{{span style='color:blue;font-family:monospace;',←→ piSize}} **{{span style='color:blue;font-family:monospace;',pPath}} パラメータによって参照されるバッファのサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) を指定する整数へのポインタ。返り時には、これはパス文字列の実際のサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) になります。文字列バッファが小さすぎるためにこの関数が失敗した場合、返り時の {{span style='color:blue;font-family:monospace;',piSize}} の値はバッファに必要とされるサイズになります。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_BUFFER_TOO_SMALL}} **あなたが提供したバッファのサイズは文字列を保持するには小さすぎます。そのため、この関数は必要とされるサイズを {{span style='color:blue;font-family:monospace;',piSize}} パラメータに返します。 *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} すべてのコンジット マネージャ エラー コードについての説明は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' この関数は現在の Windows ユーザのための {{goto Core\Path 3,Core\Path|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値を取得します。このパスは各 Windows ユーザで異なるかもしれないため、「システム レベル」パスとは対応しません。 コンジット マネージャ バージョン 3 以降は複数の Windows ユーザを認識します。そのため、各 Windows ユーザは別々の {{span style='color:blue;font-family:monospace;',Core\Path}} 値を持たなければなりません。ユーザ データの保管場所を Windows 標準に合わせるには、通常の値は {{span style='color:blue;font-family:monospace;',C:\Documents and Settings\\My Documents\Palm OS Desktop}} です。あなたが HotSync ユーザのディレクトリのフル パスを必要とする場合、{{goto UmGetUserDirectory,UmGetUserDirectory()|C/C++ Sync Suite Reference601/16}} を呼び出し、得られたパスを {{span style='color:blue;font-family:monospace;',Core\Path}} 値に付加します。 ::NOTE :::{{span style='color:blue;font-family:monospace;',CmGetCorePath()}} によって返されるパスは必ずしも {{span style='color:blue;font-family:monospace;',CondMgr.dll, Instaide.dll}} や他のサポート DLL の場所ではありません。これらの DLL はユーザ ディレクトリとは異なるディレクトリの中にある可能性があります。HotSync ユーザ ディレクトリの場所を決定するためだけに {{span style='color:blue;font-family:monospace;',CmGetCorePath()}} を使用してください。{{br}}{{br}}HotSync マネージャ、{{span style='color:blue;font-family:monospace;',CondMgr.dll, Instaide.dll}}、その他の DLL のパスを決定するには、この関数の代わりに {{goto CmGetHotSyncExecPath,CmGetHotSyncExecPath()|C/C++ Sync Suite Reference601/11-2}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmGetHotSyncExecPath,CmGetHotSyncExecPath()|C/C++ Sync Suite Reference601/11-2}} !{{anchor CmGetCreatorArgument}}CmGetCreatorArgument 関数 {{goto top,^TOP^}} '''目的''' (使用を推奨されなくなりました) 指定されたコンジットのための {{goto Arguments 1,Arguments|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetCreatorArgument ( const char *pCreatorID, TCHAR *pArgument, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreatorID}} **コンジットのクリエイタ ID 文字列。あなたはこのコンジットの {{goto Arguments 1,Arguments|Introduction to Conduit Development601/A}} 値を取得しようとしています。 *{{span style='color:blue;font-family:monospace;',← pArgument}} **文字列バッファへのポインタ。返り時には、これは指定されたコンジットの {{goto Arguments 1,Arguments|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値になります。 *{{span style='color:blue;font-family:monospace;',←→ piSize}} **{{span style='color:blue;font-family:monospace;',pArguments}} パラメータによって参照されるバッファのサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) を指定する整数へのポインタ。返り時には、これは {{goto Arguments 1,Arguments|Introduction to Conduit Development601/A}} 文字列の実際のサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) になります。文字列バッファが小さすぎるためにこの関数が失敗した場合、返り時の {{span style='color:blue;font-family:monospace;',piSize}} の値はバッファに必要とされるサイズになります。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_AMBIGUOUS_CREATORID}} *{{span style='color:blue;font-family:monospace;',ERR_NO_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_BUFFER_TOO_SMALL}} **あなたが提供したバッファのサイズは文字列を保持するには小さすぎます。そのため、この関数は必要とされるサイズを {{span style='color:blue;font-family:monospace;',piSize}} パラメータに返します。 *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' CDK 6.0 では、この関数は使用を推奨されなくなりました。この値 (訳者: {{span style='color:blue;font-family:monospace;',Arguments}}) を使用する HotSync マネージャのバージョンはありません。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto Arguments 1,Arguments|Introduction to Conduit Development601/A}}, {{goto CmSetCreatorArgument,CmSetCreatorArgument()|C/C++ Sync Suite Reference601/11-3}} !{{anchor CmGetCreatorDirectory}}CmGetCreatorDirectory 関数 {{goto top,^TOP^}} '''目的''' ユーザ登録コンジットがそのコンジットのユーザ データを保存するディレクトリの名前を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetCreatorDirectory ( const char *pCreatorID, TCHAR *pDirectory, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreatorID}} **コンジットのクリエイタ ID。あなたはこのコンジットの {{goto Directory 1,Directory|Introduction to Conduit Development601/A}} 値を取得しようとしています。 *{{span style='color:blue;font-family:monospace;',← pDirectory}} **文字列バッファへのポインタ。返り時には、これは指定されたコンジットの {{goto Directory 1,Directory|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値になります。 *{{span style='color:blue;font-family:monospace;',←→ piSize}} **{{span style='color:blue;font-family:monospace;',pDirectory}} パラメータによって参照されるバッファのサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) を指定する整数へのポインタ。返り時には、これは {{goto Directory 1,Directory|Introduction to Conduit Development601/A}} 文字列の実際のサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) になります。文字列バッファが小さすぎるためにこの関数が失敗した場合、返り時の {{span style='color:blue;font-family:monospace;',piSize}} の値はバッファに必要とされるサイズになります。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_AMBIGUOUS_CREATORID}} *{{span style='color:blue;font-family:monospace;',ERR_NO_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_BUFFER_TOO_SMALL}} **あなたが提供したバッファのサイズは文字列を保持するには小さすぎます。そのため、この関数は必要とされるサイズを {{span style='color:blue;font-family:monospace;',piSize}} パラメータに返します。 *{{span style='color:blue;font-family:monospace;',ERR_VALUE_NOT_FOUND}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' この関数は指定されたコンジットの {{goto Directory 1,Directory|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値を取得します。ディレクトリ文字列は現在の HotSync ユーザのディレクトリ下にあるディレクトリ - これはコンジットがそのコンジットのユーザ データとサポート ファイルを保存するために作成します - を指定します。例えば、{{span style='color:blue;font-family:monospace;',Directory}} の値が {{span style='color:blue;font-family:monospace;',DateBook}} であり、{{goto Core\Path 3,Core\Path|Introduction to Conduit Development601/A}} の値が通常の値である場合、このコンジットのデータ ディレクトリへのフル パスは以下のようになります: C:\Documents and Settings\\My Documents \Palm OS Desktop\\DateBook この関数は現在の Windows ユーザのために登録されているコンジットについての情報を取得します。システムのために登録されているコンジットに対するこの情報 (訳者: ユーザ データを保存するディレクトリ名) を取得するには、この関数の代わりに {{goto CmGetSystemCreatorDirectory,CmGetSystemCreatorDirectory()|C/C++ Sync Suite Reference601/11-2}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto Directory 1,Directory|Introduction to Conduit Development601/A}}, {{goto CmSetCreatorDirectory,CmSetCreatorDirectory()|C/C++ Sync Suite Reference601/11-3}}, {{goto CmGetSystemCreatorDirectory,CmGetSystemCreatorDirectory()|C/C++ Sync Suite Reference601/11-2}} !{{anchor CmGetCreatorFile}}CmGetCreatorFile 関数 {{goto top,^TOP^}} '''目的''' ユーザ登録コンジットのためのデータ ファイルの名前を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetCreatorFile ( const char *pCreatorID, TCHAR *pFile, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreatorID}} **コンジットのクリエイタ ID 文字列。あなたはこのコンジットの {{goto File 1,File|Introduction to Conduit Development601/A}} 値を取得しようとしています。 *{{span style='color:blue;font-family:monospace;',← pFile}} **文字バッファへのポインタ。返り時には、これは {{goto File 1,File|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値を保持しています。 *{{span style='color:blue;font-family:monospace;',←→ piSize}} **{{span style='color:blue;font-family:monospace;',pFile}} パラメータによって参照されるバッファのサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) を指定する整数へのポインタ。返り時には、これは {{goto File 1,File|Introduction to Conduit Development601/A}} 文字列の実際のサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) になります。文字列バッファが小さすぎるためにこの関数が失敗した場合、返り時の {{span style='color:blue;font-family:monospace;',piSize}} の値はバッファに必要とされるサイズになります。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_AMBIGUOUS_CREATORID}} *{{span style='color:blue;font-family:monospace;',ERR_NO_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_BUFFER_TOO_SMALL}} **あなたが提供したバッファのサイズは文字列を保持するには小さすぎます。そのため、この関数は必要とされるサイズを {{span style='color:blue;font-family:monospace;',piSize}} パラメータに返します。 *{{span style='color:blue;font-family:monospace;',ERR_VALUE_NOT_FOUND}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' この関数は指定されたコンジットの {{goto File 1,File|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値を取得します。ファイル文字列はハンドヘルド データベースと同期されるデスクトップ ファイルの名前を指定します。このファイルの位置はどこにでもなり得ますが、通例では {{goto CmGetCreatorDirectory,CmGetCreatorDirectory()}} によって返されるディレクトリの中になります。 この関数は現在の Windows ユーザのために登録されているコンジットについての情報を取得します。システムのために登録されているコンジットに対するこの情報 (訳者: ユーザ登録コンジットのためのデータ ファイルの名前) を取得するには、この関数の代わりに {{goto CmGetSystemCreatorFile,CmGetSystemCreatorFile()|C/C++ Sync Suite Reference601/11-2}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto File 1,File|Introduction to Conduit Development601/A}}, {{goto CmSetCreatorFile,CmSetCreatorFile()|C/C++ Sync Suite Reference601/11-3}}, {{goto CmGetSystemCreatorFile,CmGetSystemCreatorFile()|C/C++ Sync Suite Reference601/11-2}} !{{anchor CmGetCreatorIDList}}CmGetCreatorIDList 関数 {{goto top,^TOP^}} '''目的''' 現在の Windows ユーザのために登録されているすべてのコンジットのクリエイタ ID のリストを取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetCreatorIDList ( CM_CREATORLIST_TYPE pCreatorList, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreatorList}} **クリエイタ ID を保持している {{goto CM_CREATORLIST_ITEM_TYPE,CM_CREATORLIST_ITEM_TYPE}} 構造体の配列へのポインタ。 *{{span style='color:blue;font-family:monospace;',←→ piSize}} **{{span style='color:blue;font-family:monospace;',pCreatorList}} パラメータによって参照される配列の中にあるエントリの数を指定する整数へのポインタ。返り時には、これは配列の中にあるアイテムの実際の数になります。配列が小さすぎるためにこの関数が失敗した場合、返り時の {{span style='color:blue;font-family:monospace;',piSize}} の値は必要とされる配列アイテム数になります。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_BUFFER_TOO_SMALL}} **あなたが提供した配列のサイズはクリエイタ ID アイテムを保持するには小さすぎます。そのため、この関数は必要とされるアイテム数を {{span style='color:blue;font-family:monospace;',piSize}} パラメータに返します。 エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' この関数はタイプ {{goto CM_CREATORLIST_ITEM_TYPE,CM_CREATORLIST_ITEM_TYPE}} の構造体の配列への {{span style='color:blue;font-family:monospace;',CM_CREATORLIST_TYPE}} ポインタ経由でクリエイタ ID のリストを返します。 この関数は現在の Windows ユーザのために登録されているコンジットについての情報を取得します。システムのために登録されているコンジットに対するこの情報 (訳者: コンジットのクリエイタ ID のリスト) を取得するには、この関数の代わりに {{goto CmGetSystemCreatorIDList,CmGetSystemCreatorIDList()|C/C++ Sync Suite Reference601/11-2}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto CM_CREATORLIST_ITEM_TYPE,CM_CREATORLIST_ITEM_TYPE}}, {{goto CmGetSystemCreatorIDList,CmGetSystemCreatorIDList()|C/C++ Sync Suite Reference601/11-2}}, {{goto CmInstallConduitByStruct,CmInstallConduitByStruct()|C/C++ Sync Suite Reference601/11-2}} !{{anchor CmGetCreatorInfo}}CmGetCreatorInfo 関数 {{goto top,^TOP^}} '''目的''' (使用を推奨されなくなりました) ユーザ登録コンジットに関連付けられている文字列を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetCreatorInfo ( const char *pCreatorID, TCHAR *pInfo, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreatorID}} **コンジットのクリエイタ ID 文字列。あなたはこのコンジットの {{goto Information 1,Information|Introduction to Conduit Development601/A}} 値を取得しようとしています。 *{{span style='color:blue;font-family:monospace;',← pInfo}} **文字バッファへのポインタ。返り時には、これは指定されたコンジットの {{goto Information 1,Information|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値になります。 *{{span style='color:blue;font-family:monospace;',←→ piSize}} **{{span style='color:blue;font-family:monospace;',pInfo}} パラメータによって参照されるバッファのサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) を指定する整数へのポインタ。返り時には、これは {{goto Information 1,Information|Introduction to Conduit Development601/A}} 文字列の実際のサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) になります。文字列バッファが小さすぎるためにこの関数が失敗した場合、返り時の {{span style='color:blue;font-family:monospace;',piSize}} の値はバッファに必要とされるサイズになります。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_AMBIGUOUS_CREATORID}} *{{span style='color:blue;font-family:monospace;',ERR_NO_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_BUFFER_TOO_SMALL}} **あなたが提供したバッファのサイズは文字列を保持するには小さすぎます。そのため、この関数は必要とされるサイズを {{span style='color:blue;font-family:monospace;',piSize}} パラメータに返します。 *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' CDK 6.0 では、この関数は使用を推奨されなくなりました。この値 (訳者: {{span style='color:blue;font-family:monospace;',Information}}) を使用する HotSync マネージャのバージョンはありません。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto Information 1,Information|Introduction to Conduit Development601/A}}, {{goto CmSetCreatorInfo,CmSetCreatorInfo()|C/C++ Sync Suite Reference601/11-3}} !{{anchor CmGetCreatorIntegrate}}CmGetCreatorIntegrate 関数 {{goto top,^TOP^}} '''目的''' (使用を推奨されなくなりました) 指定されたコンジットのための {{goto Integrate 1,Integrate|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetCreatorIntegrate ( const char *pCreatorID, DWORD *pdwIntegrate ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreatorID}} **コンジットのクリエイタ ID 文字列。あなたはこのコンジットの {{goto Integrate 1,Integrate|Introduction to Conduit Development601/A}} 値を取得しようとしています。 *{{span style='color:blue;font-family:monospace;',← pdwIntegrate}} **{{span style='color:blue;font-family:monospace;',DWORD}} 値へのポインタ。返り時には、これは指定されたコンジットの {{goto Integrate 1,Integrate|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値になります。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_AMBIGUOUS_CREATORID}} *{{span style='color:blue;font-family:monospace;',ERR_NO_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' CDK 6.0 では、この関数は使用を推奨されなくなりました。この値 (訳者: {{span style='color:blue;font-family:monospace;',Integrate}}) を使用する HotSync マネージャのバージョンはありません。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto Integrate 1,Integrate|Introduction to Conduit Development601/A}}, {{goto CmSetCreatorIntegrate,CmSetCreatorIntegrate()|C/C++ Sync Suite Reference601/11-3}} !{{anchor CmGetCreatorModule}}CmGetCreatorModule 関数 {{goto top,^TOP^}} '''目的''' (使用を推奨されなくなりました) 指定されたコンジットのための {{goto Module 1,Module|Introduction to Conduit Development601/A}}}} コンフィグレーション エントリの値を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetCreatorModule ( const char *pCreatorID, TCHAR *pModule, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreatorID}} **コンジットのクリエイタ ID 文字列。あなたはこのコンジットの {{goto Module 1,Module|Introduction to Conduit Development601/A}} 値を取得しようとしています。 *{{span style='color:blue;font-family:monospace;',← pModule}} **文字バッファへのポインタ。返り時には、これは指定されたコンジットの {{goto Module 1,Module|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値になります。 *{{span style='color:blue;font-family:monospace;',←→ piSize}} **{{span style='color:blue;font-family:monospace;',pModule}} パラメータによって参照されるバッファのサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) を指定する整数へのポインタ。返り時には、これは {{goto Module 1,Module|Introduction to Conduit Development601/A}} 文字列の実際のサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) になります。文字列バッファが小さすぎるためにこの関数が失敗した場合、返り時の {{span style='color:blue;font-family:monospace;',piSize}} の値はバッファに必要とされるサイズになります。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_AMBIGUOUS_CREATORID}} *{{span style='color:blue;font-family:monospace;',ERR_NO_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_BUFFER_TOO_SMALL}} **あなたが提供したバッファのサイズは文字列を保持するには小さすぎます。そのため、この関数は必要とされるサイズを {{span style='color:blue;font-family:monospace;',piSize}} パラメータに返します。 *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' CDK 6.0 では、この関数は使用を推奨されなくなりました。この値 (訳者: {{span style='color:blue;font-family:monospace;',Module}}) を使用する HotSync マネージャのバージョンはありません。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto Module 1,Module|Introduction to Conduit Development601/A}}, {{goto CmSetCreatorModule,CmSetCreatorModule()|C/C++ Sync Suite Reference601/11-3}} !{{anchor CmGetCreatorName}}CmGetCreatorName 関数 {{goto top,^TOP^}} '''目的''' ユーザ登録コンジットのファイル名を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetCreatorName ( const char *pCreatorID, TCHAR *pConduitName, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreatorID}} **コンジットのクリエイタ ID 文字列。あなたはこのコンジットの {{goto Conduit 1,Conduit|Introduction to Conduit Development601/A}} 値を取得しようとしています。 *{{span style='color:blue;font-family:monospace;',← pConduitName}} **文字バッファへのポインタ。返り時には、これは指定されたコンジットの {{goto Conduit 1,Conduit|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値になります。 *{{span style='color:blue;font-family:monospace;',←→ piSize}} **{{span style='color:blue;font-family:monospace;',pConduit}} パラメータによって参照されるバッファのサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) を指定する整数へのポインタ。返り時には、これは {{goto Conduit 1,Conduit|Introduction to Conduit Development601/A}} 文字列の実際のサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) になります。文字列バッファが小さすぎるためにこの関数が失敗した場合、返り時の {{span style='color:blue;font-family:monospace;',piSize}} の値はバッファに必要とされるサイズになります。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_AMBIGUOUS_CREATORID}} *{{span style='color:blue;font-family:monospace;',ERR_NO_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_BUFFER_TOO_SMALL}} **あなたが提供したバッファのサイズは文字列を保持するには小さすぎます。そのため、この関数は必要とされるサイズを {{span style='color:blue;font-family:monospace;',piSize}} パラメータに返します。 *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' この関数は指定されたコンジットの {{goto Conduit 1,Conduit|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値を取得します。この値は指定されたクリエイタ ID で登録されているコンジット DLL のファイル名です - 例えば、{{span style='color:blue;font-family:monospace;',ToDoCond.dll}} はクリエイタ ID {{span style='color:blue;font-family:monospace;','todo'}} で登録されています。 この関数は現在の Windows ユーザのために登録されているコンジットについての情報を取得します。システムのために登録されているコンジットに対するこの情報 (訳者: コンジット DLL のファイル名) を取得するには、この関数の代わりに {{goto CmGetSystemCreatorName,CmGetSystemCreatorName()|C/C++ Sync Suite Reference601/11-2}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto Conduit 1,Conduit}}, {{goto CmSetCreatorName,CmSetCreatorName()|C/C++ Sync Suite Reference601/11-3}}, {{goto CmGetSystemCreatorName,CmGetSystemCreatorName()|C/C++ Sync Suite Reference601/11-2}} !{{anchor CmGetCreatorPriority}}CmGetCreatorPriority 関数 {{goto top,^TOP^}} '''目的''' ユーザ登録コンジットの実行優先順位を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetCreatorPriority ( const char *pCreatorID, DWORD *pdwPriority ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreatorID}} **コンジットのクリエイタ ID。あなたはこのコンジットの {{goto Priority 1,Priority|Introduction to Conduit Development601/A}} 値を取得しようとしています。 *{{span style='color:blue;font-family:monospace;',← pdwPriority}} **{{span style='color:blue;font-family:monospace;',DWORD}} 値へのポインタ。返り時には、これは指定されたコンジットの {{goto Priority 1,Priority|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値になります。これは 0 から 4 までの値です。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_AMBIGUOUS_CREATORID}} *{{span style='color:blue;font-family:monospace;',ERR_NO_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} *{{span style='color:blue;font-family:monospace;',ERR_VALUE_NOT_FOUND}} エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' この関数は指定されたコンジットの {{goto Priority 1,Priority|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値を取得します。HotSync マネージャはコンジットを実行する順番 - つまり、HotSync マネージャがコンジットの {{span style='color:blue;font-family:monospace;',OpenCondui()}} エントリ ポイントを呼び出す順番 - を決定するために優先順位値を使用します。HotSync マネージャは 0 の値を持つコンジットを最初に実行し、4 の値を持つコンジットを最後に実行します。 この関数は現在の Windows ユーザのために登録されているコンジットについての情報を取得します。システムのために登録されているコンジットに対するこの情報 (訳者: コンジット実行優先順位) を取得するには、この関数の代わりに {{goto CmGetSystemCreatorPrioritye,CmGetSystemCreatorPriority()|C/C++ Sync Suite Reference601/11-2}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto Priority 1,Priority|Introduction to Conduit Development601/A}}, {{goto CmSetCreatorPriority,CmSetCreatorPriority()|C/C++ Sync Suite Reference601/11-3}}, {{goto CmGetSystemCreatorPriority,CmGetSystemCreatorPriority()|C/C++ Sync Suite Reference601/11-2}} !{{anchor CmGetCreatorRemote}}CmGetCreatorRemote 関数 {{goto top,^TOP^}} '''目的''' ユーザ登録コンジットに関連付けされているハンドヘルド上のデータベースの名前を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetCreatorRemote ( const char *pCreatorID, TCHAR *pRemoteDB, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreatorID}} **コンジットのクリエイタ ID 文字列。あなたはこのコンジットの {{goto Remote 1,Remote|Introduction to Conduit Development601/A}} 値を取得しようとしています。 *{{span style='color:blue;font-family:monospace;',← pRemoteDB}} **文字バッファへのポインタ。返り時には、これは指定されたコンジットの {{goto Remote 1,Remote|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値になります。 *{{span style='color:blue;font-family:monospace;',←→ piSize}} **{{span style='color:blue;font-family:monospace;',pRemoteDB}} パラメータによって参照されるバッファのサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) を指定する整数へのポインタ。返り時には、これは {{goto Remote 1,Remote|Introduction to Conduit Development601/A}} 文字列の実際のサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) になります。文字列バッファが小さすぎるためにこの関数が失敗した場合、返り時の {{span style='color:blue;font-family:monospace;',piSize}} の値はバッファに必要とされるサイズになります。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_AMBIGUOUS_CREATORID}} *{{span style='color:blue;font-family:monospace;',ERR_NO_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_BUFFER_TOO_SMALL}} **あなたが提供したバッファのサイズは文字列を保持するには小さすぎます。そのため、この関数は必要とされるサイズを {{span style='color:blue;font-family:monospace;',piSize}} パラメータに返します。 *{{span style='color:blue;font-family:monospace;',ERR_VALUE_NOT_FOUND}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' この関数は指定されたコンジットの {{goto Remote 1,Remote|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値を取得します。この値はこのコンジットに関連付けされているハンドヘルド上の単一のデータベースに名前をつけます。 ::NOTE :::コンジットはハンドヘルド上の複数のデータベースにアクセスできますが、{{span style='color:blue;font-family:monospace;',CmGetCreatorRemote()}} はハンドヘルド データベース名を 1 つだけ返します: このコンジットのための {{span style='color:blue;font-family:monospace;',Remote}} コンフィグレーション エントリの中で指定されている (1 つの) 名前です。あなたがこのコンフィグレーション エントリを使うかどうかを決定する手助けとして、{{goto Remote 1,"\"Remote\"|Introduction to Conduit Development601/A"}} の説明を参照してください。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto Remote 1,Remote|Introduction to Conduit Development601/A}}, {{goto CmSetCreatorRemote,CmSetCreatorRemote()|C/C++ Sync Suite Reference601/11-3}}, {{goto CmGetSystemCreatorRemote,CmGetSystemCreatorRemote()|C/C++ Sync Suite Reference601/11-2}} !{{anchor CmGetCreatorTitle}}CmGetCreatorTitle 関数 {{goto top,^TOP^}} '''目的''' ユーザ登録コンジットのディスプレイ名を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetCreatorTitle ( const char *pCreatorID, TCHAR *pTitle, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreatorID}} **コンジットのクリエイタ ID 文字列。あなたはこのコンジットの {{goto Name 1,Name|Introduction to Conduit Development601/A}} 値を取得しようとしています。 *{{span style='color:blue;font-family:monospace;',← pTitle}} **文字バッファへのポインタ。返り時には、これは指定されたコンジットの {{goto Name 1,Name|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値になります。 *{{span style='color:blue;font-family:monospace;',←→ piSize}} **{{span style='color:blue;font-family:monospace;',pTitle}} パラメータによって参照されるバッファのサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) を指定する整数へのポインタ。返り時には、これは {{goto Name 1,Name|Introduction to Conduit Development601/A}} 文字列の実際のサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) になります。文字列バッファが小さすぎるためにこの関数が失敗した場合、返り時の {{span style='color:blue;font-family:monospace;',piSize}} の値はバッファに必要とされるサイズになります。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_AMBIGUOUS_CREATORID}} *{{span style='color:blue;font-family:monospace;',ERR_NO_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_BUFFER_TOO_SMALL}} **あなたが提供したバッファのサイズは文字列を保持するには小さすぎます。そのため、この関数は必要とされるサイズを {{span style='color:blue;font-family:monospace;',piSize}} パラメータに返します。 *{{span style='color:blue;font-family:monospace;',ERR_VALUE_NOT_FOUND}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' この関数は指定されたコンジットの {{goto Name 1,Name|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値を取得します。この値が {{span style='color:blue;font-family:monospace;',NULL}} ではない場合、HotSync マネージャはそれを '''Custom''' ダイアログ ボックスと '''HotSync Progress''' ダイアログ ボックスでコンジットの表示名として使用します。この値が {{span style='color:blue;font-family:monospace;',NULL}} である場合、HotSync マネージャはコンジットの {{goto GetConduitInfo,GetConduitInfo()|C/C++ Sync Suite Reference601/6}} エントリ ポイントによって返される値を使用し、それが失敗した場合はコンジットの {{goto GetConduitName,GetConduitName()|C/C++ Sync Suite Reference601/6}} エントリ ポイントを使用します。 この関数は現在の Windows ユーザのために登録されているコンジットについての情報を取得します。システムのために登録されているコンジットに対するこの情報 (訳者: コンジットの表示名) を取得するには、この関数の代わりに {{goto CmGetSystemCreatorTitle,CmGetSystemCreatorTitle()|C/C++ Sync Suite Reference601/11-2}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto Name 1,Name|Introduction to Conduit Development601/A}}, {{goto CmSetCreatorTitle,CmSetCreatorTitle()|C/C++ Sync Suite Reference601/11-3}}, {{goto CmGetSystemCreatorTitle,CmGetSystemCreatorTitle()|C/C++ Sync Suite Reference601/11-2}} !{{anchor CmGetCreatorType}}CmGetCreatorType 関数 {{goto top,^TOP^}} '''目的''' (使用を推奨されなくなりました) 指定されたコンジットのタイプ - コンポーネントまたはアプリケーション - を返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetCreatorType ( const char *pCreator ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreator}} **コンジットのクリエイタ ID 文字列。あなたはこのコンジットのタイプ値を取得しようとしています。 '''返り値''' 成功した場合、{{goto Conduit Information Types,「コンジット情報タイプ」}} で説明されているコンジット タイプ定数値の 1 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_NO_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} '''コメント''' CDK 6.0 では、この関数は使用を推奨されなくなりました。この値 (訳者: ??。{{goto Conduit Information Types,「コンジット情報タイプ」}} は使用を推奨されなくなった定数ではないが?) を使用する HotSync マネージャのバージョンはありません。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて !{{anchor CmGetCreatorUser}}CmGetCreatorUser 関数 {{goto top,^TOP^}} '''目的''' (使用を推奨されなくなりました) 指定されたコンジットの {{goto Username 1,Username|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetCreatorUser ( const char *pCreatorID, TCHAR *pUsername, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreatorID}} **コンジットのクリエイタ ID。あなたはこのコンジットの {{goto Username 1,Username|Introduction to Conduit Development601/A}} 値を取得しようとしています。 *{{span style='color:blue;font-family:monospace;',← pUsername}} **文字バッファへのポインタ。返り時には、これは指定されたコンジットの {{goto Username 1,Username|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値になっています。 *{{span style='color:blue;font-family:monospace;',←→ piSizepiSize}} **{{span style='color:blue;font-family:monospace;',pUsername}} パラメータによって参照されるバッファのサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) を指定する整数へのポインタ。返り時には、これは {{goto Username 1,Username|Introduction to Conduit Development601/A}} 文字列の実際のサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) になります。文字列バッファが小さすぎるためにこの関数が失敗した場合、返り時の {{span style='color:blue;font-family:monospace;',piSize}} の値はバッファに必要とされるサイズになります。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_AMBIGUOUS_CREATORID}} *{{span style='color:blue;font-family:monospace;',ERR_NO_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_BUFFER_TOO_SMALL}} **あなたが提供したバッファのサイズは文字列を保持するには小さすぎます。そのため、この関数は必要とされるサイズを {{span style='color:blue;font-family:monospace;',piSize}} パラメータに返します。 *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' CDK 6.0 では、この関数は使用を推奨されなくなりました。この値 (訳者: {{span style='color:blue;font-family:monospace;',Username}}) を使用する HotSync マネージャのバージョンはありません。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto Username 1,Username|Introduction to Conduit Development601/A}}, {{goto CmSetCreatorUser,CmSetCreatorUser()|C/C++ Sync Suite Reference601/11-3}} !{{anchor CmGetCreatorValueDword}}CmGetCreatorValueDword 関数 {{goto top,^TOP^}} '''目的''' ユーザ登録コンジットの {{span style='color:blue;font-family:monospace;',DWORD}} コンフィグレーション エントリ値を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetCreatorValueDword ( const char *pCreatorID, TCHAR *pValue, DWORD *dwValue, DWORD dwDefault ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreatorID}} **コンジットのクリエイタ ID 文字列。あなたはこのコンジットのコンフィグレーション エントリ値を取得しようとしています。 *{{span style='color:blue;font-family:monospace;',→ pValue}} **コンフィグレーション エントリ名。 *{{span style='color:blue;font-family:monospace;',← dwValue}} **返り時には、これは {{span style='color:blue;font-family:monospace;',pValue}} によって指定されたコンフィグレーション エントリの値を保持しています。 *{{span style='color:blue;font-family:monospace;',→ dwDefault}} **指定された {{span style='color:blue;font-family:monospace;',pValue}} 値がコンフィグレーション エントリの中で見つからなかった場合に {{span style='color:blue;font-family:monospace;',dwValue}} に返されるデフォルトの値。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_AMBIGUOUS_CREATORID}} *{{span style='color:blue;font-family:monospace;',ERR_NO_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} *{{span style='color:blue;font-family:monospace;',ERR_VALUE_NOT_FOUND}} エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' この関数はコンジットのコンフィグレーション エントリから {{span style='color:blue;font-family:monospace;',DWORD}} 値を取得します。この関数は名前によってコンジット コンフィグレーション エントリ値を取得する汎用関数です。あなたはあなた自身が使用するために {{goto CmSetCreatorValueDword,CmSetCreatorValueDword()|C/C++ Sync Suite Reference601/11-3}} で作成したコンフィグレーション エントリの値を取得するためにこの関数を使用できます。 コンジット マネージャが {{span style='color:blue;font-family:monospace;',pValue}} で指定されたコンフィグレーション エントリ名を見つけられなかった場合、この関数は {{span style='color:blue;font-family:monospace;',dwValue}} を {{span style='color:blue;font-family:monospace;',dwDefault}} の値に等しくして 0 (成功) を返します。しかしながら、{{span style='color:blue;font-family:monospace;',pCreatorID}} で指定されたコンジットが存在しない場合、この関数は {{span style='color:blue;font-family:monospace;',dwValue}} を {{span style='color:blue;font-family:monospace;',dwDefault}} に等しくすることはせず、エラーを返します。 この関数は現在の Windows ユーザのために登録されているコンジットについての情報を取得します。システムのために登録されているコンジットに対するこの情報 (訳者: コンコンフィグレーション エントリ) を取得するには、この関数の代わりに {{goto CmGetSystemCreatorValueDword,CmGetSystemCreatorValueDword()|C/C++ Sync Suite Reference601/11-2}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmSetCreatorValueDword,CmSetCreatorValueDword()|C/C++ Sync Suite Reference601/11-3}}, {{goto CmGetSystemCreatorValueDword,CmGetSystemCreatorValueDword()|C/C++ Sync Suite Reference601/11-2}}, {{goto CmGetCreatorValueString,CmGetCreatorValueString()}} !{{anchor CmGetCreatorValueString}}CmGetCreatorValueString 関数 {{goto top,^TOP^}} '''目的''' ユーザ登録コンジットの文字列コンフィグレーション エントリ値を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetCreatorValueString ( const char *pCreatorID, TCHAR *pValue, TCHAR *pString, int *piSize, TCHAR *pDefault ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreatorID}} **コンジットのクリエイタ ID 文字列。あなたはこのコンジットのコンフィグレーション エントリ値を取得しようとしています。 *{{span style='color:blue;font-family:monospace;',→ pValue}} **コンフィグレーション エントリ名。 *{{span style='color:blue;font-family:monospace;',← pString}} **文字バッファへのポインタ。返り時には、これは {{span style='color:blue;font-family:monospace;',pValue}} によって指定されたコンフィグレーション エントリの値になっています。 *{{span style='color:blue;font-family:monospace;',←→ piSize}} **{{span style='color:blue;font-family:monospace;',pString}} パラメータによって参照されるバッファのサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) を指定する整数へのポインタ。返り時には、これは文字列の実際のサイズ ({{span style='color:blue;font-family:monospace;',TCHAR}} の数) になります。文字列バッファが小さすぎるためにこの関数が失敗した場合、返り時の {{span style='color:blue;font-family:monospace;',piSize}} の値はバッファに必要とされるサイズになります。 *{{span style='color:blue;font-family:monospace;',→ pDefault}} **指定された {{span style='color:blue;font-family:monospace;',pValue}} 名がコンフィグレーション エントリの中に見つからなかった場合に {{span style='color:blue;font-family:monospace;',pString}} に返されるデフォルトの値。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_AMBIGUOUS_CREATORID}} *{{span style='color:blue;font-family:monospace;',ERR_NO_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_BUFFER_TOO_SMALL}} **あなたが提供したバッファのサイズは文字列を保持するには小さすぎます。そのため、この関数は必要とされるサイズを {{span style='color:blue;font-family:monospace;',piSize}} パラメータに返します。 *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' この関数はコンジットのコンフィグレーション エントリから文字列値を取得します。この関数は名前によってコンジット コンフィグレーション エントリ値を取得する汎用関数です。あなたはあなた自身が使用するために {{goto CmSetCreatorValueString,CmSetCreatorValueString()|C/C++ Sync Suite Reference601/11-3}} で作成したコンフィグレーション エントリの値を取得するためにこの関数を使用できます。 コンジット マネージャが {{span style='color:blue;font-family:monospace;',pValue}} で指定されたコンフィグレーション エントリ名を見つけられなかった場合、この関数はデフォルト値を戻して ({{span style='color:blue;font-family:monospace;',pString}} を {{span style='color:blue;font-family:monospace;',pDefault}} の値に等しくして)、0 (成功) を返します。しかしながら、{{span style='color:blue;font-family:monospace;',pCreatorID}} で指定されたコンジットが存在しない場合、この関数はデフォルト値を戻さず、エラーを返します。 この関数は現在の Windows ユーザのために登録されているコンジットについての情報を取得します。システムのために登録されているコンジットに対するこの情報 (訳者: コンコンフィグレーション エントリ) を取得するには、この関数の代わりに {{goto CmGetSystemCreatorValueString,CmGetSystemCreatorValueString()|C/C++ Sync Suite Reference601/11-2}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmSetCreatorValueString,CmSetCreatorValueString()|C/C++ Sync Suite Reference601/11-3}}, {{goto CmGetSystemCreatorValueString,CmGetSystemCreatorValueString()|C/C++ Sync Suite Reference601/11-2}}, {{goto CmGetCreatorValueDword,CmGetCreatorValueDword()}} [[↑ 11 章のトップへ|C/C++ Sync Suite Reference601/11]] [[11 章のページ 2 へ →|C/C++ Sync Suite Reference601/11-2]] {{div_end}} {{div_begin "style='border-top-style:solid;border-top-width:1px;border-top-color:silver;'"}} [[← 10 章に戻る|C/C++ Sync Suite Reference601/10]] [[↑トップへ|C/C++ Sync Suite Reference601]] [[12 章に進む →|C/C++ Sync Suite Reference601/12]] {{div_end}}