{{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 (ページ 2) {{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,コンジット マネージャ構造体|C/C++ Sync Suite Reference601/11-1}} **{{goto CmConduitType,CmConduitType|C/C++ Sync Suite Reference601/11-1}} **{{goto CmConduitType2,CmConduitType2|C/C++ Sync Suite Reference601/11-1}} **{{goto CmDiscoveryInfoType,CmDiscoveryInfoType|C/C++ Sync Suite Reference601/11-1}} **{{goto CM_CREATORLIST_ITEM_TYPE,CM_CREATORLIST_ITEM_TYPE|C/C++ Sync Suite Reference601/11-1}} *{{goto Conduit Manager Constants,コンジット マネージャ定数|C/C++ Sync Suite Reference601/11-1}} **{{goto Conduit Information Types,コンジット情報タイプ|C/C++ Sync Suite Reference601/11-1}} **{{goto Communications Ports,通信ポート|C/C++ Sync Suite Reference601/11-1}} **{{goto Conduit Manager Versions,コンジット マネージャ バージョン|C/C++ Sync Suite Reference601/11-1}} **{{goto Miscellaneous Constants,その他の定数|C/C++ Sync Suite Reference601/11-1}} *{{goto Conduit Manager Functions,コンジット マネージャ関数|C/C++ Sync Suite Reference601/11-1}} **{{goto CmConvertCreatorIDToString,CmConvertCreatorIDToString|C/C++ Sync Suite Reference601/11-1}} **{{goto CmConvertStringToCreatorID,CmConvertStringToCreatorID|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetBackupConduit,CmGetBackupConduit|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetComPort,CmGetComPort|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetConduitByCreator,CmGetConduitByCreator|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetConduitByIndex,CmGetConduitByIndex|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetConduitCount,CmGetConduitCount|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetConduitCreatorID,CmGetConduitCreatorID|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetCorePath,CmGetCorePath|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetCreatorArgument,CmGetCreatorArgument|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetCreatorDirectory,CmGetCreatorDirectory|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetCreatorFile,CmGetCreatorFile|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetCreatorIDList,CmGetCreatorIDList|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetCreatorInfo,CmGetCreatorInfo|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetCreatorIntegrate,CmGetCreatorIntegrate|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetCreatorModule,CmGetCreatorModule|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetCreatorName,CmGetCreatorName|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetCreatorPriority,CmGetCreatorPriority|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetCreatorRemote,CmGetCreatorRemote|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetCreatorTitle,CmGetCreatorTitle|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetCreatorType,CmGetCreatorType|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetCreatorUser,CmGetCreatorUser|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetCreatorValueDword,CmGetCreatorValueDword|C/C++ Sync Suite Reference601/11-1}} **{{goto CmGetCreatorValueString,CmGetCreatorValueString|C/C++ Sync Suite Reference601/11-1}} *(ページ 2) **{{goto CmGetDiscoveryInfoByIndex,CmGetDiscoveryInfoByIndex}} **{{goto CmGetHotSyncExecPath,CmGetHotSyncExecPath}} **{{goto CmGetLibVersion,CmGetLibVersion}} **{{goto CmGetNotifierDll,CmGetNotifierDll}} **{{goto CmGetPCIdentifier,CmGetPCIdentifier}} **{{goto CmGetSystemBackupConduit,CmGetSystemBackupConduit}} **{{goto CmGetSystemConduitByCreator,CmGetSystemConduitByCreator}} **{{goto CmGetSystemConduitByIndex,CmGetSystemConduitByIndex}} **{{goto CmGetSystemConduitCount,CmGetSystemConduitCount}} **{{goto CmGetSystemConduitCreatorID,CmGetSystemConduitCreatorID}} **{{goto CmGetSystemCreatorDirectory,CmGetSystemCreatorDirectory}} **{{goto CmGetSystemCreatorFile,CmGetSystemCreatorFile}} **{{goto CmGetSystemCreatorIDList,CmGetSystemCreatorIDList}} **{{goto CmGetSystemCreatorName,CmGetSystemCreatorName}} **{{goto CmGetSystemCreatorPriority,CmGetSystemCreatorPriority}} **{{goto CmGetSystemCreatorRemote,CmGetSystemCreatorRemote}} **{{goto CmGetSystemCreatorTitle,CmGetSystemCreatorTitle}} **{{goto CmGetSystemCreatorValueDword,CmGetSystemCreatorValueDword}} **{{goto CmGetSystemCreatorValueString,CmGetSystemCreatorValueString}} **{{goto CmGetSystemDiscoveryInfoByIndex,CmGetSystemDiscoveryInfoByIndex}} **{{goto CmGetSystemHotSyncExecPath,CmGetSystemHotSyncExecPath}} **{{goto CmInstallConduit,CmInstallConduit}} **{{goto CmInstallConduitByStruct,CmInstallConduitByStruct}} **{{goto CmInstallCreator,CmInstallCreator}} **{{goto CmInstallSystemConduitByStruct,CmInstallSystemConduitByStruct}} **{{goto CmInstallSystemCreator,CmInstallSystemCreator}} **{{goto CmIsCurrentUserAdmin,CmIsCurrentUserAdmin}} **{{goto CmRemoveConduitByCreatorID,CmRemoveConduitByCreatorID}} **{{goto CmRemoveConduitByIndex,CmRemoveConduitByIndex}} **{{goto CmRemoveSystemConduitByCreatorID,CmRemoveSystemConduitByCreatorID}} **{{goto CmRemoveSystemConduitByIndex,CmRemoveSystemConduitByIndex}} **{{goto CmRestoreHotSyncSettings,CmRestoreHotSyncSettings}} *(ページ 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 章のページ 1 へ|C/C++ Sync Suite Reference601/11-1]]　[[↑　11 章のトップへ|C/C++ Sync Suite Reference601/11]]　[[11 章のページ 3 へ　→|C/C++ Sync Suite Reference601/11-3]] !{{anchor CmGetDiscoveryInfoByIndex}}CmGetDiscoveryInfoByIndex 関数 {{goto top,^TOP^}} '''目的''' HotSync マネージャがどのようにユーザ登録コンジットを見つけ出すのかについての情報を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetDiscoveryInfoByIndex ( int iIndex, CmDiscoveryInfoType &sDiscoveryInfo ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ iIndex}} **現在の Windows ユーザのために登録されているコンジットの 0 ベース インデックス。インデックスの最大値を決定するには {{goto CmGetConduitCount,CmGetConduitCount()|C/C++ Sync Suite Reference601/11-1}} を呼び出します。 *{{span style='color:blue;font-family:monospace;',← sDiscoveryInfo}} **HotSync マネージャが指定されたコンジットを発見できたかどうか、発見できた場合はそのコンジットが {{span style='color:blue;font-family:monospace;',Conduits}} フォルダの中にあるのかそれともコンジット コンフィグレーション エントリの中にあるのかを説明する {{goto CmDiscoverInfoType,CmDiscoverInfoType|C/C++ Sync Suite Reference601/11-1}} 構造体への参照。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_INDEX_OUT_OF_RANGE}} **指定されたインデックス値は範囲外です。 '''コメント''' {{goto CmDiscoverInfoType,CmDiscoverInfoType|C/C++ Sync Suite Reference601/11-1}} 構造体の {{span style='color:blue;font-family:monospace;',bLoadable}} フィールドが {{span style='color:blue;font-family:monospace;',FALSE}} である場合、指定されたコンジットは適切に登録されておらず HotSync マネージャはそれを呼び出すことができないということに注意してください。 この関数は現在の Windows ユーザのために登録されているコンジットについての情報を取得します。システムのために登録されているコンジットに対してこの情報 (訳者: HotSync マネージャがどのようにコンジットを見つけ出すかという情報) を取得するには、{{goto CmGetSystemDiscoverInfoByIndex,CmGetSystemDiscoverInfoByIndex()}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmDiscoveryInfoType,CmDiscoveryInfoType|C/C++ Sync Suite Reference601/11-1}}, {{goto CmGetSystemDiscoveryInfoByIndex,CmGetSystemDiscoveryInfoByIndex()}} !{{anchor CmGetHotSyncExecPath}}CmGetHotSyncExecPath 関数 {{goto top,^TOP^}} '''目的''' (使用を推奨されなくなりました) デスクトップ コンピュータ上の HotSync マネージャ実行ファイルのパスとファイル名を取得します。(サポート DLL のパスを取得するには {{span style='color:blue;font-family:monospace;',HotSync.exe}} ファイル名を取り除きます。) '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetHotSyncExecPath ( TCHAR *pPath, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',← pPath}} **文字バッファへのポインタ。返り時には、これは HotSync マネージャ実行ファイルのパスとファイル名 - 例えば、{{span style='color:blue;font-family:monospace;',C:\Program Files\PalmSource\Desktop\HotSync.exe}} - になります。HotSync マネージャがインストールされていない場合、このパラメータは空の文字列を指します。 *{{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_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}} を参照してください。 '''コメント''' CDK 6.0 では、この関数は使用を推奨されなくなりました。しかしながら、この関数はそれまでのコンジット インストーラとの互換性を保つために未だ利用可能です。他のすべてのコンジット インストーラはこの関数の代わりにコンジット マネージャ バージョン 3 以降で利用可能な {{goto CmGetSystemHotSyncExecPath,CmGetSystemHotSyncExecPath()}} を使用すべきです。この値 (訳者: {{span style='color:blue;font-family:monospace;',Arguments}}) を使用する HotSync マネージャのバージョンはありません。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmGetCorePath,CmGetCorePath()|C/C++ Sync Suite Reference601/11-1}}, {{goto CmGetSystemHotSyncExecPath,CmGetSystemHotSyncExecPath()}} !{{anchor CmGetLibVersion}}CmGetLibVersion 関数 {{goto top,^TOP^}} '''目的''' 現在ロードされている DLL からコンジット マネージャ API のバージョン番号を返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' WORD CmGetLibVersion () '''パラメータ''' ありません。 '''返り値''' {{goto Conduit Manager Versions,「コンジット マネージャ バージョン」|C/C++ Sync Suite Reference601/11-1}} で定義されている {{span style='color:blue;font-family:monospace;',CM_UPDATE...}} 定数の 1 つを返します。 '''コメント''' この章の「互換性」部分では、それぞれの関数、構造体、定数はどのバージョンのコンジット マネージャ API で使用可能なのかが示されています。例えば、「コンジット マネージャ バージョン: 2 以降」というのは、{{span style='color:blue;font-family:monospace;',CmGetLibVersion()}} が 0x0002 以上の値を返す場合にその API 要素は使用可能であるということを示しています。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて !{{anchor CmGetNotifierDll}}CmGetNotifierDll 関数 {{goto top,^TOP^}} '''目的''' (使用を推奨されなくなりました) 通知機能 DLL の名前を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetNotifierDll ( int iIndex, TCHAR *pNotifier, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ iIndex}} **あなたが取得しようとしている通知機能の整数インデックス。 *{{span style='color:blue;font-family:monospace;',← pNotifier}} **文字バッファへのポインタ。返り時には、これは通知機能 DLL の名前になります。 *{{span style='color:blue;font-family:monospace;',←→ piSize}} **{{span style='color:blue;font-family:monospace;',pNotifier}} パラメータによって参照されるバッファのサイズ ({{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_VALUE_NOT_FOUND}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_POINTER}} エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' この関数はコンフィグレーション エントリの HotSync マネージャ部分の中に値として保存されている通知機能 DLL の名前を取得します。最初の通知機能コンフィグレーション エントリは Notifier0 という名前を付けられていて、2 番目のエントリには Notifier1 という名前が付けられています。 ::重要 :::この関数は使用を推奨されなくなりました。この関数の代わりに通知機能インストール マネージャ関数の 1 つを使用してください ([[第 13 章 「通知機能インストール マネージャ API」|C/C++ Sync Suite Reference601/13]] を参照してください)。{{span style='color:blue;font-family:monospace;',CmGetNotifierDLL()}} は下位互換性のために残されています。しかしながら、通知機能インストール マネージャはあなたがより容易に通知機能をインストール、アンインストール、変更することを可能にします。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto NmGetByIndex,NmGetByIndex()|C/C++ Sync Suite Reference601/13}} や他の [[「通知機能インストール マネージャ API」|C/C++ Sync Suite Reference601/13]] !{{anchor CmGetPCIdentifier}}CmGetPCIdentifier 関数 {{goto top,^TOP^}} '''目的''' デスクトップ コンピュータ上の現在の Windows ユーザの固有識別子を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetPCIdentifier ( DWORD *pdwPCID ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pdwPCID}} **{{span style='color:blue;font-family:monospace;',DWORD}} 値へのポインタ。返り時には、これは PC 固有識別子になります。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{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 HotSync Manager\PCIdentifier 3,HotSync Manager\PCIdentifier|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値を取得します。HotSync マネージャは HotSync マネージャを実行する各 Windows ユーザに対して異なる PC ID を生成します。同じ Windows ログインを使用している各 HotSync ユーザは同じ PC ID を持ちます。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto HotSync Manager\PCIdentifier 3,HotSync Manager\PCIdentifier|Introduction to Conduit Development601/A}}, {{goto CmSetPCIdentifier,CmSetPCIdentifier()|C/C++ Sync Suite Reference601/11-3}} !{{anchor CmGetSystemBackupConduit}}CmGetSystemBackupConduit 関数 {{goto top,^TOP^}} '''目的''' システムのためのバックアップ コンジットとして登録されているコンジットの名前を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetSystemBackupConduit ( 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}} *{{span style='color:blue;font-family:monospace;',ERR_UNABLE_TO_SET_CONDUIT_VALUE}} すべてのコンジット マネージャ エラー コードについての説明は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' この関数はシステムのためのに HotSync マネージャによって使用される {{goto HotSync Manager\BackupConduit 3,HotSync Manager\BackupConduit|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値を取得します。現在の Windows ユーザのために登録されているバックアップ コンジットに対してこの情報 (訳者: バックアップ コンジットの名前) を取得するには、{{goto CmGetBackupConduit,CmGetBackupConduit()|C/C++ Sync Suite Reference601/11-1}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto HotSync Manager\BackupConduit 3,HotSync Manager\BackupConduit|Introduction to Conduit Development601/A}}, {{goto CmGetBackupConduit,CmGetBackupConduit()|C/C++ Sync Suite Reference601/11-1}}, {{goto CmSetSystemBackupConduit,CmSetSystemBackupConduit()|C/C++ Sync Suite Reference601/11-3}} !{{anchor CmGetSystemConduitByCreator}}CmGetSystemConduitByCreator 関数 {{goto top,^TOP^}} '''目的''' 与えられたコンジットのクリエイタ ID からシステムのために登録されているコンジットについての情報を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetSystemConduitByCreator ( const char *pCreatorID, CmConduitType2 &sConduitInfo ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreatorID}} **コンジットのクリエイタ ID。文字列で与えます。 *{{span style='color:blue;font-family:monospace;',← sConduitInfo}} **指定されたコンジットについて説明する {{goto CmConduitType2,CmConduitType2|C/C++ Sync Suite Reference601/11-1}} 構造体への参照。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_NO_CONDUIT}} *{{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_HANDLE}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} すべてのコンジット マネージャ エラー コードについての説明は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' この関数はシステムのために登録されているコンジットについての情報を取得します。現在の Windows ユーザのために登録されているコンジットに対してこの情報 (訳者: {{goto CmConduitType2,CmConduitType2|C/C++ Sync Suite Reference601/11-1}} 構造体) を取得するには、{{goto CmGetConduitByCreator,CmGetConduitByCreator()|C/C++ Sync Suite Reference601/11-1}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmConduitType2,CmConduitType2|C/C++ Sync Suite Reference601/11-1}}, {{goto CmInstallSystemConduitByStruct,CmInstallSystemConduitByStruct()}}, {{goto CmGetSystemConduitByIndex,CmGetSystemConduitByIndex(), {{goto CmGetConduitByCreator,CmGetConduitByCreator()|C/C++ Sync Suite Reference601/11-1}} !{{anchor CmGetSystemConduitByIndex}}CmGetSystemConduitByIndex 関数 {{goto top,^TOP^}} '''目的''' 与えられたコンジットのインデックスからシステムのために登録されているコンジットについての情報を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetSystemConduitByIndex ( int iIndex, CmConduitType2 &sConduitInfo ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ iIndex}} **システムのために登録されているコンジットの 0 ベースのインデックス。インデックスの最大値を決定するには {{goto CmGetSystemConduitCount,CmGetSystemConduitCount()}} を呼び出します。 *{{span style='color:blue;font-family:monospace;',← }} **指定されたコンジットについて説明する {{goto CmConduitType2,CmConduitType2|C/C++ Sync Suite Reference601/11-1}} への参照。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値を返します: *{{span style='color:blue;font-family:monospace;',ERR_INDEX_OUT_OF_RANGE}} '''コメント''' この関数はシステムのために登録されているコンジットについての情報を取得します。現在の Windows ユーザのために登録されているコンジットに対してこの情報 (訳者: {{goto CmConduitType2,CmConduitType2|C/C++ Sync Suite Reference601/11-1}} 構造体) を取得するには、{{goto CmGetConduitByIndex,CmGetConduitByIndex()|C/C++ Sync Suite Reference601/11-1}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmConduitType2,CmConduitType2|C/C++ Sync Suite Reference601/11-1}}, {{goto CmInstallSystemConduitByStruct,CmInstallSystemConduitByStruct()}}, {{goto CmGetSystemConduitCount,CmGetSystemConduitCount()}}, {{goto CmGetConduitByIndex,CmGetConduitByIndex()|C/C++ Sync Suite Reference601/11-1}}, {{goto CmGetSystemConduitByCreator,CmGetSystemConduitByCreator()}} !{{anchor CmGetSystemConduitCount}}CmGetSystemConduitCount 関数 {{goto top,^TOP^}} '''目的''' システムのために HotSync マネージャに登録されているコンジットの数を返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetSystemConduitCount ( void ) '''パラメータ''' ありません。 '''返り値''' 成功した場合、登録されているコンジットの数を返します。 失敗した場合、以下の非 0 のエラー コード値を返します: *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} すべてのコンジット マネージャ エラー コードについての説明は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' 返されるコンジット数に含まれるのはシステムのために登録されているすべてのコンジットです。このコンジット数にはシステムの {{span style='color:blue;font-family:monospace;',Conduits}} フォルダに置かれることによって登録されたコンジット (フォルダ登録) とコンフィグレーション エントリによって登録されたコンジット (通常通りの登録) が含まれます。この数はバックアップ コンジットやインストール コンジットを含まず、現在の Windows ユーザのために登録されているコンジットも含みません。現在の Windows ユーザのために登録されているコンジットに対してこの情報 (訳者: コンジット数) を取得するには、{{goto CmGetConduitCount,CmGetConduitCount()|C/C++ Sync Suite Reference601/11-1}} を呼び出します。 あなたは {{goto CmGetSystemConduitByIndex,CmGetSystemConduitByIndex()}} で使用することができる有効なインデックス値の範囲を決定するためにこの数を使用することができます。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmGetConduitCount,CmGetConduitCount()|C/C++ Sync Suite Reference601/11-1}}, {{goto CmGetSystemConduitByIndex,CmGetSystemConduitByIndex()}} !{{anchor CmGetSystemConduitCreatorID}}CmGetSystemConduitCreatorID 関数 {{goto top,^TOP^}} '''目的''' システムのために登録されているコンジットのクリエイタ ID を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetSystemConduitCreatorID ( int iIndex, char *pCreatorID, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ iIndex}} **システムのために登録されているコンジットの 0 ベースのインデックス。インデックスの最大値を決定するには {{goto CmGetSystemConduitCount,CmGetSystemConduitCount()}} を呼び出します。 *{{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 CmGetConduitCreatorID,CmGetConduitCreatorID()|C/C++ Sync Suite Reference601/11-1}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmGetSystemConduitCount,CmGetSystemConduitCount()}}, {{goto CmGetConduitCreatorID,CmGetConduitCreatorID()|C/C++ Sync Suite Reference601/11-1}}, {{goto CmInstallSystemConduitByStruct,CmInstallSystemConduitByStruct()}} !{{anchor CmGetSystemCreatorDirectory}}CmGetSystemCreatorDirectory 関数 {{goto top,^TOP^}} '''目的''' システム登録コンジットがそのコンジットのユーザ データを保存するディレクトリの名前を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetSystemCreatorDirectory ( 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 CmGetCreatorDirectory,CmGetCreatorDirectory()|C/C++ Sync Suite Reference601/11-1}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto Directory 1,Directory|Introduction to Conduit Development601/A}}, {{goto CmSetSystemCreatorDirectory,CmSetSystemCreatorDirectory()|C/C++ Sync Suite Reference601/11-3}}, {{goto CmGetCreatorDirectory,CmGetCreatorDirectory()|C/C++ Sync Suite Reference601/11-1}} !{{anchor CmGetSystemCreatorFile}}CmGetSystemCreatorFile 関数 {{goto top,^TOP^}} '''目的''' システム登録コンジットのためのデータ ファイルの名前を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetSystemCreatorFile ( 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 CmGetSystemCreatorDirectory,CmGetSystemCreatorDirectory()}} によって返されるディレクトリの中になります。 この関数はシステムのために登録されているコンジットについての情報を取得します。現在の Windows ユーザのために登録されているコンジットに対してこの情報 (システム登録コンジットのためのデータ ファイルの名前) を取得するには、{{goto CmGetCreatorFile,CmGetCreatorFile()|C/C++ Sync Suite Reference601/11-1}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto File 1,File|Introduction to Conduit Development601/A}, {{goto CmSetSystemCreatorFile,CmSetSystemCreatorFile()|C/C++ Sync Suite Reference601/11-3}}, {{goto CmGetCreatorFile,CmGetCreatorFile()|C/C++ Sync Suite Reference601/11-1}} !{{anchor CmGetSystemCreatorIDList}}CmGetSystemCreatorIDList 関数 {{goto top,^TOP^}} '''目的''' システムのために登録されているすべてのコンジットのクリエイタ ID のリストを取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetSystemCreatorIDList ( CM_CREATORLIST_TYPE pCreatorList, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreatorList}} **クリエイタ ID を保持している {{goto CM_CREATORLIST_ITEM_TYPE,CM_CREATORLIST_ITEM_TYPE|C/C++ Sync Suite Reference601/11-1}} 構造体の配列へのポインタ。 *{{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}} を呼び出します。 この関数はシステムのために登録されているコンジットについての情報を取得します。現在の Windows ユーザのために登録されているコンジットに対してこの情報 (訳者: コンジットのクリエイタ ID のリスト) を取得するには、{{goto CmGetCreatorIDList,CmGetCreatorIDList()|C/C++ Sync Suite Reference601/11-1}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto CM_CREATORLIST_ITEM_TYPE,CM_CREATORLIST_ITEM_TYPE|C/C++ Sync Suite Reference601/11-1}}, {{goto CmGetCreatorIDList,CmGetCreatorIDList()|C/C++ Sync Suite Reference601/11-1}}, {{goto CmInstallSystemConduitByStruct,CmInstallSystemConduitByStruct()}} !{{anchor CmGetSystemCreatorName}}CmGetSystemCreatorName 関数 {{goto top,^TOP^}} '''目的''' システム登録コンジットのファイル名を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetSystemCreatorName ( 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 ユーザのために登録されているコンジットに対してこの情報 (訳者: コンジットのファイル名) を取得するには、{{goto CmGetCreatorName,CmGetCreatorName()|C/C++ Sync Suite Reference601/11-1}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto Conduit 1,Conduit|Introduction to Conduit Development601/A}}, {{goto CmSetSystemCreatorName,CmSetSystemCreatorName()|C/C++ Sync Suite Reference601/11-3}}, {{goto CmGetCreatorName,CmGetCreatorName()|C/C++ Sync Suite Reference601/11-1}} !{{anchor CmGetSystemCreatorPriority}}CmGetSystemCreatorPriority 関数 {{goto top,^TOP^}} '''目的''' システム登録コンジットの実行優先順位を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetSystemCreatorPriority ( 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 CmGetCreatorPriority,CmGetCreatorPriority()|C/C++ Sync Suite Reference601/11-1}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto Priority 1,Priority|Introduction to Conduit Development601/A}}, {{goto CmSetSystemCreatorPriority,CmSetSystemCreatorPriority()|C/C++ Sync Suite Reference601/11-3}}, {{goto CmGetCreatorPriority,CmGetCreatorPriority()|C/C++ Sync Suite Reference601/11-1}} !{{anchor CmGetSystemCreatorRemote}}CmGetSystemCreatorRemote 関数 {{goto top,^TOP^}} '''目的''' システム登録コンジットに関連付けされているハンドヘルド上のデータベースの名前を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetSystemCreatorRemote ( 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"}} の説明を参照してください。 この関数はシステムのために登録されているコンジットについての情報を取得します。現在の Windows ユーザのために登録されているコンジットに対してこの情報 (訳者: このシステム登録コンジットに関連付けされているハンドヘルド状のデータベース名) を取得するには、{{goto CmGetCreatorRemote,CmGetCreatorRemote()|C/C++ Sync Suite Reference601/11-1}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto Remote 1,Remote|Introduction to Conduit Development601/A}}, {{goto CmSetSystemCreatorRemote,CmSetSystemCreatorRemote()|C/C++ Sync Suite Reference601/11-3}}, {{goto CmGetCreatorRemote,CmGetCreatorRemote()|C/C++ Sync Suite Reference601/11-1}} !{{anchor CmGetSystemCreatorTitle}}CmGetSystemCreatorTitle 関数 {{goto top,^TOP^}} '''目的''' システム登録コンジットの表示名を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetSystemCreatorTitle ( 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 CmGetCreatorTitle,CmGetCreatorTitle()|C/C++ Sync Suite Reference601/11-1}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto Name 1,Name|Introduction to Conduit Development601/A}}, {{goto CmSetSystemCreatorTitle,CmSetSystemCreatorTitle()|C/C++ Sync Suite Reference601/11-3}}, {{goto CmGetCreatorTitle,CmGetCreatorTitle()|C/C++ Sync Suite Reference601/11-1}} !{{anchor CmGetSystemCreatorValueDword}}CmGetSystemCreatorValueDword 関数 {{goto top,^TOP^}} '''目的''' システム登録コンジットのための {{span style='color:blue;font-family:monospace;',DWORD}} コンフィグレーション エントリ値を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetSystemCreatorValueDword ( 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 CmSetSystemCreatorValueDword,CmSetSystemCreatorValueDword()|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 CmGetCreatorValueDword,CmGetCreatorValueDword()|C/C++ Sync Suite Reference601/11-1}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmSetSystemCreatorValueDword,CmSetSystemCreatorValueDword()|C/C++ Sync Suite Reference601/11-3}}, {{goto CmGetCreatorValueDword,CmGetCreatorValueDword()|C/C++ Sync Suite Reference601/11-1}}, {{goto CmGetSystemCreatorValueString,CmGetSystemCreatorValueString()}} !{{anchor CmGetSystemCreatorValueString}}CmGetSystemCreatorValueString 関数 {{goto top,^TOP^}} '''目的''' システム登録コンジットのための文字列コンフィグレーション エントリ値を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetSystemCreatorValueString ( 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 CmSetSystemCreatorValueString,CmSetSystemCreatorValueString()|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 CmGetCreatorValueString,CmGetCreatorValueString()|C/C++ Sync Suite Reference601/11-1}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmSetSystemCreatorValueString,CmSetSystemCreatorValueString()|C/C++ Sync Suite Reference601/11-3}}, {{goto CmGetCreatorValueString,CmGetCreatorValueString()|C/C++ Sync Suite Reference601/11-1}}, {{goto CmGetSystemCreatorValueDword,CmGetSystemCreatorValueDword()}} !{{anchor CmGetSystemDiscoveryInfoByIndex}}CmGetSystemDiscoveryInfoByIndex 関数 {{goto top,^TOP^}} '''目的''' HotSync マネージャがシステム登録コンジットを発見する方法を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetSystemDiscoveryInfoByIndex ( int iIndex, CmDiscoveryInfoType &sDiscoveryInfo ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ iIndex}} **現在の Windows ユーザのために登録されているコンジットの 0 ベース インデックス。インデックスの最大値を決定するには {{goto CmGetSystemConduitCount,CmGetSystemConduitCount()}} を呼び出します。 *{{span style='color:blue;font-family:monospace;',← sDiscoveryInfo}} **HotSync マネージャが指定されたコンジットを発見できたかどうか、発見できた場合はそのコンジットが {{span style='color:blue;font-family:monospace;',Conduits}} フォルダの中にあるのかそれともコンジット コンフィグレーション エントリの中にあるのかを説明する {{goto CmDiscoverInfoType,CmDiscoverInfoType|C/C++ Sync Suite Reference601/11-1}} 構造体への参照。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_INDEX_OUT_OF_RANGE}} **指定されたインデックス値は範囲外です。 '''コメント''' {{goto CmDiscoverInfoType,CmDiscoverInfoType|C/C++ Sync Suite Reference601/11-1}} 構造体の {{span style='color:blue;font-family:monospace;',bLoadable}} フィールドが {{span style='color:blue;font-family:monospace;',FALSE}} である場合、指定されたコンジットは適切に登録されておらず HotSync マネージャはそれを呼び出すことができないということに注意してください。 この関数はシステムのために登録されているコンジットについての情報を取得します。現在の Windows ユーザのために登録されているコンジットに対してこの情報 (訳者: HotSync マネージャがどのようにコンジットを見つけ出すかという情報) を取得するには、{{goto CmGetDiscoverInfoByIndex,CmGetDiscoverInfoByIndex()}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmDiscoveryInfoType,CmDiscoveryInfoType|C/C++ Sync Suite Reference601/11-1}}, {{goto CmGetDiscoveryInfoByIndex,CmGetDiscoveryInfoByIndex()}} !{{anchor CmGetSystemHotSyncExecPath}}CmGetSystemHotSyncExecPath 関数 {{goto top,^TOP^}} '''目的''' デスクトップ コンピュータ上の HotSync マネージャ実行ファイルのパスとファイル名を取得します。（サポート DLL のパスを取得するには {{span style='color:blue;font-family:monospace;',HotSync.exe}} ファイル名を取り除きます。） '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmGetSystemHotSyncExecPath ( TCHAR *pPath, int *piSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',← pPath}} **文字バッファへのポインタ。返り時に、これは HotSync マネージャ実行ファイルのパスとファイル名になります - 例えば、{{span style='color:blue;font-family:monospace;',C:\Program Files\PalmSource\Desktop\HotSync.exe}} です。 *{{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_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}} を参照してください。 '''コメント''' この関数は HotSync マネージャの {{goto Core\HotSyncPath 3,Core\HotSyncPath|Introduction to Conduit Development601/A}} コンフィグレーション エントリの値を取得します。この値はデスクトップ コンピュータ上の HotSync 実行形式ファイルのパスとファイル名です。HotSync マネージャがインストールされていない場合、{{span style='color:blue;font-family:monospace;',pPath}} パラメータは空の文字列を指します。 ::NOTE :::{{span style='color:blue;font-family:monospace;',CondMgr.dll, Instaide.dll, UserData.dll}} のようなサポート DLL のパスを調べるには、この関数を呼び出して、{{span style='color:blue;font-family:monospace;',pPath}} によって指される文字列バッファの最後尾からファイル名 {{span style='color:blue;font-family:monospace;',HotSync.exe}} を取り除きます。 '''HotSync マネージャのバージョンが 6 よりも前''' '''HotSync マネージャのバージョンが 6 以降''' '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmGetCorePath,CmGetCorePath()|C/C++ Sync Suite Reference601/11-1}}, {{goto CmGetHotSyncExecPath,CmGetHotSyncExecPath()}} !{{anchor CmInstallConduit}}CmInstallConduit 関数 {{goto top,^TOP^}} '''目的''' コンジットを現在の Windows ユーザのために HotSync マネージャに登録します。{{span style='color:blue;font-family:monospace;',CmConduitType}} 構造体を使用します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmInstallConduit ( HANDLE hStruct ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ hStruct}} **インストールするコンジットのハンドル。これは {{goto CmConduitType,CmConduitType|C/C++ Sync Suite Reference601/11-1}} 構造体へのハンドルです。 '''返り値''' 成功した場合、0 を返します。 不成功時には以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_CONDUIT_MGR}} *{{span style='color:blue;font-family:monospace;',ERR_NO_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_NO_MEMORY}} *{{span style='color:blue;font-family:monospace;',ERR_CREATORID_ALREADY_IN_USE}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_UNABLE_TO_CREATE_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_UNABLE_TO_SET_CONDUIT_VALUE}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_HANDLE}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' コンジットを登録するには、{{goto CmConduitType,CmConduitType|C/C++ Sync Suite Reference601/11-1}} 構造体のフィールドに情報を埋め込み、構造体へのハンドルをこの関数に渡します。 ::NOTE :::PalmSource はこの関数の代わりに {{goto CmInstallConduitByStruct,CmInstallConduitByStruct()}} や {{goto CmInstallSystemConduitByStruct,CmInstallSystemConduitByStruct()}} を使用することを推奨します。これらの関数は {{span style='color:blue;font-family:monospace;',CmInstallConduit()}} とは異なりメモリ管理を必要としません。単一の構造体を用いて通常通りの方法でコンジットを登録することについての更なる情報は、''C/C++ Sync Suite Companion'' の {{goto Writing a Single Structure,「単一の構造体を作成する」|C/C++ Sync Suite Companion601/9-1}} を参照してください。 この関数は現在の Windows ユーザのためにコンジットを登録します。システムのためにコンジットを登録するには、{{goto CmInstallSystemConduitByStruct,CmInstallSystemConduitByStruct()}} や {{goto CmInstallSystemCreator,CmInstallSystemCreator()}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmConduitType,CmConduitType|C/C++ Sync Suite Reference601/11-1}}, {{goto CmInstallConduitByStruct,CmInstallConduitByStruct()}}, {{goto CmInstallCreator,CmInstallCreator()}}, {{goto CmInstallSystemConduitByStruct,CmInstallSystemConduitByStruct()}}, {{goto CmInstallSystemCreator,CmInstallSystemCreator()}} !{{anchor CmInstallConduitByStruct}}CmInstallConduitByStruct 関数 {{goto top,^TOP^}} '''目的''' コンジットを現在の Windows ユーザのために HotSync マネージャに登録します。{{goto CmConduitType2,CmConduitType2|C/C++ Sync Suite Reference601/11-1}} 構造体を使用します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmInstallConduitByStruct ( CmConduitType2 &sConduitInfo ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ sConduitInfo}} **コンジット登録情報を指定する {{goto CmConduitType2,CmConduitType2|C/C++ Sync Suite Reference601/11-1}} 構造体への参照。 '''返り値''' 成功時には 0 を返します。 不成功時には以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_CONDUIT_MGR}} *{{span style='color:blue;font-family:monospace;',ERR_NO_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_NO_MEMORY}} *{{span style='color:blue;font-family:monospace;',ERR_CREATORID_ALREADY_IN_USE}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_UNABLE_TO_CREATE_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_UNABLE_TO_SET_CONDUIT_VALUE}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' コンジットを登録するには、{{goto CmConduitType2,CmConduitType2|C/C++ Sync Suite Reference601/11-1}} 構造体のフィールドに情報を埋め込み、その構造体への参照をこの関数に渡します。単一の構造体で通常通りにコンジットを登録する方法についての更なる情報は、''C/C++ Sync Suite Companion'' の {{goto Writing a Single Structure,「単一の構造体を作成する」|C/C++ Sync Suite Companion601/9-1}} を参照してください。 この関数はコンジットを現在の Windows ユーザのために登録します。システムのためにコンジットを登録するには、{{goto CmInstallSystemConduitByStruct,CmInstallSystemConduitByStruct()}} または {{goto CmInstallSystemCreator,CmInstallSystemCreator()}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmConduitType2,CmConduitType2|C/C++ Sync Suite Reference601/11-1}}, {{goto CmInstallCreator,CmInstallCreator()}}, {{goto CmInstallSystemConduitByStruct,CmInstallSystemConduitByStruct()}}, {{goto CmInstallSystemCreator,CmInstallSystemCreator()}} !{{anchor CmInstallCreator}}CmInstallCreator 関数 {{goto top,^TOP^}} '''目的''' 新しいコンジット クリエイタ ID を現在の Windows ユーザのために HotSync マネージャに登録します (登録を完了するには {{span style='color:blue;font-family:monospace;',CmSetCreator...()}} 関数を呼び出すことが必要です)。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmInstallCreator ( const char *pCreator, int iType ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreator}} **コンジットのクリエイタ ID 文字列。これは {{goto Creator 1,Creator|Introduction to Conduit Development601/A}} コンフィグレーション エントリをセットします。 *{{span style='color:blue;font-family:monospace;',→ iType}} **コンジット タイプ。これは {{ Conduit Information Types,「コンジット情報タイプ」|C/C++ Sync Suite Reference601/11-1}} で説明されている値の 1 つです。ほとんどすべてのコンジットに対して、{{span style='color:blue;font-family:monospace;',CONDUIT_APPLICATION}} 値を指定します。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_CREATORID_ALREADY_IN_USE}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_UNABLE_TO_CREATE_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_UNABLE_TO_SET_CONDUIT_VALUE}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_TYPE}} エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' この関数はコンジット コンフィグレーション エントリの新しいセットの {{goto Creator 1,Creator|Introduction to Conduit Development601/A}} 値を作成、セットします。コンジットを登録するためにこの関数を使用するには、あなたはまずこの関数を呼び出さなければなりません; それからこの関数呼び出しが成功した場合はコンジットの残りのコンフィグレーション エントリを指定するために他の {{span style='color:blue;font-family:monospace;',CmSetCreator...()}} 関数を呼び出します。 HotSync マネージャはあなたが {{span style='color:blue;font-family:monospace;',iType}} パラメータに渡した値を区別することはありません。しかしながら、あなたは値を渡さなければなりません。その値はほとんどすべてのコンジットに対して {{span style='color:blue;font-family:monospace;',CONDUIT_APPLICATION}} になります。 この関数はまだ現在の Windows ユーザのために登録されていないコンジットのクリエイタ ID をセットします。システムのためにまだ登録されていないコンジットのクリエイタ ID をセットするには、{{goto CmInstallSystemCreator,CmInstallSystemCreator()}} や {{goto CmInstallSystemConduitByStruct,CmInstallSystemConduitByStruct()}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto Creator 1,Creator|Introduction to Conduit Development601/A}}, {{goto CmInstallConduitByStruct,CmInstallConduitByStruct()}}, {{goto CmInstallSystemCreator,CmInstallSystemCreator()}}, {{goto CmInstallSystemConduitByStruct,CmInstallSystemConduitByStruct()}} !{{anchor CmInstallSystemConduitByStruct}}CmInstallSystemConduitByStruct 関数 {{goto top,^TOP^}} '''目的''' コンジットをシステムのために HotSync マネージャに登録します。{{goto CmConduitType2,CmConduitType2|C/C++ Sync Suite Reference601/11-1}} 構造体を使用します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmInstallSystemConduitByStruct ( const CmConduitType2 &sConduitInfo ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ sConduitInfo}} **コンジット登録情報を指定する {{goto CmConduitType2,CmConduitType2|C/C++ Sync Suite Reference601/11-1}} 構造体への参照。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_CONDUIT_MGR}} *{{span style='color:blue;font-family:monospace;',ERR_NO_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_NO_MEMORY}} *{{span style='color:blue;font-family:monospace;',ERR_CREATORID_ALREADY_IN_USE}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_UNABLE_TO_CREATE_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_UNABLE_TO_SET_CONDUIT_VALUE}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} *{{span style='color:blue;font-family:monospace;',ERR_INSUFFICIENT_PRIVILEGES}} 現在の Windows ユーザはこの操作を実行するのに十分な権限を持っていません。管理者権限が必要です。 エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' コンジットを登録するには、{{goto CmConduitType2,CmConduitType2|C/C++ Sync Suite Reference601/11-1}} 構造体のフィールドに情報を埋め込み、その構造体への参照をこの関数に渡します。単一の構造体を用いて通常通りの方法でコンジットを登録することについての更なる情報は、''C/C++ Sync Suite Companion'' の {{goto Writing a Single Structure,「単一の構造体を作成する」|C/C++ Sync Suite Companion601/9-1}} を参照してください。 この関数はシステムのためにコンジットを登録します。現在の Windows ユーザのためにコンジットを登録するには、{{goto CmInstallConduitByStruct,CmInstallConduitByStruct()}} や {{goto CmInstallConduit,CmInstallConduit()}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmConduitType2,CmConduitType2|C/C++ Sync Suite Reference601/11-1}}, {{goto CmInstallSystemCreator,CmInstallSystemCreator()}}, {{goto CmInstallConduitByStruct,CmInstallConduitByStruct()}}, {{goto CmInstallCreator,CmInstallCreator()}} !{{anchor CmInstallSystemCreator}}CmInstallSystemCreator 関数 {{goto top,^TOP^}} '''目的''' 新しいコンジット クリエイタ ID を現在のシステムのために HotSync マネージャに登録します (登録を完了するには {{span style='color:blue;font-family:monospace;',CmSetSystemCreator...()}} 関数を呼び出すことが必要です)。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmInstallSystemCreator ( const char *pCreator, int iType ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreator}} **コンジットのクリエイタ ID 文字列。これは {{goto Creator 1,Creator|Introduction to Conduit Development601/A}} コンフィグレーション エントリをセットします。 *{{span style='color:blue;font-family:monospace;',→ iType}} **コンジット タイプ。これは {{ Conduit Information Types,「コンジット情報タイプ」|C/C++ Sync Suite Reference601/11-1}} で説明されている値の 1 つです。ほとんどすべてのコンジットに対して、{{span style='color:blue;font-family:monospace;',CONDUIT_APPLICATION}} 値を指定します。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_CREATORID_ALREADY_IN_USE}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} *{{span style='color:blue;font-family:monospace;',ERR_UNABLE_TO_CREATE_CONDUIT}} *{{span style='color:blue;font-family:monospace;',ERR_UNABLE_TO_SET_CONDUIT_VALUE}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_ID}} *{{span style='color:blue;font-family:monospace;',ERR_INVALID_CREATOR_TYPE}} *{{span style='color:blue;font-family:monospace;',ERR_INSUFFICIENT_PRIVILEGES}} 現在の Windows ユーザはこの操作を実行するのに十分な権限を持っていません。管理者権限が必要です。 エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' この関数はコンジット コンフィグレーション エントリの新しいセットの {{goto Creator 1,Creator|Introduction to Conduit Development601/A}} 値を作成、セットします。コンジットを登録するためにこの関数を使用するには、あなたはまずこの関数を呼び出さなければなりません; それからこの関数呼び出しが成功した場合はコンジットの残りのコンフィグレーション エントリを指定するために他の {{span style='color:blue;font-family:monospace;',CmSetSystemCreator...()}} 関数を呼び出します。 HotSync マネージャはあなたが {{span style='color:blue;font-family:monospace;',iType}} パラメータに渡した値を区別することはありません。しかしながら、あなたは値を渡さなければなりません。その値はほとんどすべてのコンジットに対して {{span style='color:blue;font-family:monospace;',CONDUIT_APPLICATION}} になります。 この関数はまだシステムのために登録されていないコンジットのクリエイタ ID をセットします。現在の Windows ユーザのためにまだ登録されていないコンジットのクリエイタ ID をセットするには、{{goto CmInstallCreator,CmInstallCreator()}} や {{goto CmInstallConduitByStruct,CmInstallConduitByStruct()}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto Creator 1,Creator|Introduction to Conduit Development601/A}}, {{goto CmInstallSystemConduitByStruct,CmInstallSystemConduitByStruct()}}, {{goto CmInstallCreator,CmInstallCreator()}}, {{goto CmInstallConduitByStruct,CmInstallConduitByStruct()}} !{{anchor CmIsCurrentUserAdmin}}CmIsCurrentUserAdmin 関数 {{goto top,^TOP^}} '''目的''' 現在のユーザが Windows 管理者権限を持っているかどうかを決定します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' BOOL CmIsCurrentUserAdmin () '''パラメータ''' ありません。 '''返り値''' 現在のユーザが管理者権限を持っている場合、{{span style='color:blue;font-family:monospace;',TRUE}} を返します。 持っていない場合、{{span style='color:blue;font-family:monospace;',FALSE}} を返します。 '''コメント''' システムのためにコンフィグレーション エントリをセットするすべてのコンジット マネージャ関数 ({{span style='color:blue;font-family:monospace;',CmSet...System...()}} 関数や他の関数) は、現在の Windows ユーザが管理者権限を持っていない場合、{{span style='color:blue;font-family:monospace;',ERR_INSUFFICIENT_PRIVILEGES}} エラーを返します。しかしながら、それは NTFS ファイル システムである場合にのみです。あなたがこれらの関数を呼び出す前にこれらの関数が失敗するかどうかを決定するには、関数呼び出しに先立って {{span style='color:blue;font-family:monospace;',CmIsCurrentUserAdmin()}} を呼び出します。管理者権限を持っていないユーザであっても、コンジット マネージャ関数はシステム レベル情報を読み込むことはできます。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて !{{anchor CmRemoveConduitByCreatorID}}CmRemoveConduitByCreatorID 関数 {{goto top,^TOP^}} '''目的''' 与えられたコンジットのクリエイタ ID によって現在の Windows ユーザのために登録されているコンジットの登録を解除します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmRemoveConduitByCreatorID ( const char *pCreatorID ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreatorID}} **コンジットのクリエイタ ID 文字列。 '''返り値''' 成功した場合、削除されたコンジットの数を返します。この値は常に 1 です。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_FOLDER_NOT_FOUND}} **指定されたフォルダ登録コンジットを使用不可にすることができません。なぜなら、{{span style='color:blue;font-family:monospace;',Disabled}} フォルダが存在せず、作成することもできないためです。 *{{span style='color:blue;font-family:monospace;',ERR_UNABLE_TO_DELETE}} *{{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}} エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' クリエイタ ID を与えられるとこの関数はコンジットの登録を解除します。コンジットが通常通りの方法で登録されていた - 例えば、{{goto CmInstallConduitByStruct,CmInstallConduitByStruct()}} を使って - 場合、この関数はそのコンジットのすべてのコンフィグレーション エントリを削除します。しかしながら、コンジットが現在の Windows ユーザの {{span style='color:blue;font-family:monospace;',Conduits}} フォルダに置かれていた場合、この関数はそのコンジットを {{span style='color:blue;font-family:monospace;',Disabled}} フォルダに移動させます。そのためフォルダ登録コンジットに対してこの関数を呼び出すことは {{goto FmDisableCurrentUserConduitByPath,FmDisableCurrentUserConduitByPat()|C/C++ Sync Suite Reference601/11-3}} を呼び出すのと同じ結果となります。 この関数は現在の Windows ユーザのためのコンジットの登録を解除します。システムのためのコンジットの登録を解除するには、{{goto CmRemoveSystemConduitByCreatorID,CmRemoveSystemConduitByCreatorID()}} または {{goto CmRemoveSystemConduitByIndex,CmRemoveSystemConduitByIndex()}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmRemoveConduitByIndex,CmRemoveConduitByIndex()}}, {{goto CmRemoveSystemConduitByCreatorID,CmRemoveSystemConduitByCreatorID()}}, {{goto CmRemoveSystemConduitByIndex,CmRemoveSystemConduitByIndex()}} !{{anchor CmRemoveConduitByIndex}}CmRemoveConduitByIndex 関数 {{goto top,^TOP^}} '''目的''' 与えられたコンジットのインデックスによって現在の Windows ユーザのために登録されているコンジットの登録を解除します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmRemoveConduitByIndex ( int iIndex ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ iIndex}} **現在の Windows ユーザのために登録されているコンジットの 0 ベース インデックス。インデックスの最大値を決定するには {{goto CmGetConduitCount,CmGetConduitCount()|C/C++ Sync Suite Reference601/11-1}} を呼び出します。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_FOLDER_NOT_FOUND}} **指定されたフォルダ登録コンジットを使用不可にすることはできません。なぜなら、{{span style='color:blue;font-family:monospace;',Disabled}} フォルダが存在せず、作成することもできないためです。 *{{span style='color:blue;font-family:monospace;',ERR_INDEX_OUT_OF_RANGE}} *{{span style='color:blue;font-family:monospace;',ERR_UNABLE_TO_DELETE}} *{{span style='color:blue;font-family:monospace;',ERR_REGISTRY_ACCESS}} エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' 0 ベース インデックスが与えられるとこの関数はコンジットの登録を解除します。コンジットが通常通りの方法で登録されていた - 例えば、{{goto CmInstallConduitByStruct,CmInstallConduitByStruct()}} を用いて - 場合、この関数はそのコンジットのすべてのコンフィグレーション エントリを削除します。しかしながら、コンジットが現在の Windows ユーザの {{span style='color:blue;font-family:monospace;',Conduits}} フォルダに置かれていた場合、この関数はそのコンジットを {{span style='color:blue;font-family:monospace;',Disabled}} フォルダに移動させます。そのためフォルダ登録コンジットに対してこの関数を呼び出すことは {{goto FmDisableCurrentUserConduitByPath,FmDisableCurrentUserConduitByPat()|C/C++ Sync Suite Reference601/11-3}} を呼び出すのと同じ結果となります。 この関数は現在の Windows ユーザのためのコンジットの登録を解除します。システムのためのコンジットの登録を解除するには、{{goto CmRemoveSystemConduitByCreatorID,CmRemoveSystemConduitByCreatorID()}} または {{goto CmRemoveSystemConduitByIndex,CmRemoveSystemConduitByIndex()}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmRemoveConduitByCreatorID,CmRemoveConduitByCreatorID()}}, {{goto CmRemoveSystemConduitByIndex,CmRemoveSystemConduitByIndex()}}, {{goto CmRemoveSystemConduitByCreatorID,CmRemoveSystemConduitByCreatorID()}} !{{anchor CmRemoveSystemConduitByCreatorID}}CmRemoveSystemConduitByCreatorID 関数 {{goto top,^TOP^}} '''目的''' 与えられたコンジットのクリエイタ ID によってシステムのために登録されているコンジットの登録を解除します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmRemoveSystemConduitByCreatorID ( const char *pCreatorID ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ pCreatorID}} **コンジットのクリエイタ ID 文字列。 '''返り値''' 成功した場合、削除されたコンジットの数を返します。この値は常に 1 です。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_FOLDER_NOT_FOUND}} **指定されたフォルダ登録コンジットを使用不可にすることができません。なぜなら、{{span style='color:blue;font-family:monospace;',Disabled}} フォルダが存在せず、作成することもできないためです。 *{{span style='color:blue;font-family:monospace;',ERR_UNABLE_TO_DELETE}} *{{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_INSUFFICIENT_PRIVILEGES}} **現在の Windows ユーザはこの操作を実行するのに十分な権限を持っていません。管理者権限が必要です。 エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' クリエイタ ID を与えられるとこの関数はコンジットの登録を解除します。コンジットが通常通りの方法で登録されていた - 例えば、{{goto CmInstallSystemConduitByStruct,CmInstallSystemConduitByStruct()}} を使って - 場合、この関数はそのコンジットのすべてのコンフィグレーション エントリを削除します。しかしながら、コンジットがシステムの {{span style='color:blue;font-family:monospace;',Conduits}} フォルダに置かれていた場合、この関数はそのコンジットをシステム {{span style='color:blue;font-family:monospace;',Disabled}} フォルダに移動させます。そのためフォルダ登録コンジットに対してこの関数を呼び出すことは {{goto FmDisableSystemConduitByPath,FmDisableSystemConduitByPat()|C/C++ Sync Suite Reference601/11-3}} を呼び出すのと同じ結果となります。 この関数はシステムのためのコンジットの登録を解除します。現在の Windows ユーザのためのコンジットの登録を解除するには、{{goto CmRemoveConduitByCreatorID,CmRemoveConduitByCreatorID()}} または {{goto CmRemoveConduitByIndex,CmRemoveConduitByIndex()}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmRemoveSystemConduitByIndex,CmRemoveSystemConduitByIndex()}}, {{goto CmRemoveConduitByCreatorID,CmRemoveConduitByCreatorID()}}, {{goto CmRemoveConduitByIndex,CmRemoveConduitByIndex()}} !{{anchor CmRemoveSystemConduitByIndex}}CmRemoveSystemConduitByIndex 関数 {{goto top,^TOP^}} '''目的''' 与えられたコンジットのインデックスによってシステムのために登録されているコンジットの登録を解除します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmRemoveSystemConduitByIndex ( int iIndex ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ iIndex}} **システムのために登録されているコンジットの 0 ベース インデックス。インデックスの最大値を決定するには {{goto CmGetSystemConduitCount,CmGetSystemConduitCount()|C/C++ Sync Suite Reference601/11-1}} を呼び出します。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_FOLDER_NOT_FOUND}} **指定されたフォルダ登録コンジットを使用不可にすることができません。なぜなら、{{span style='color:blue;font-family:monospace;',Disabled}} フォルダが存在せず、作成することもできないためです。 *{{span style='color:blue;font-family:monospace;',ERR_UNABLE_TO_DELETE}} *{{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_INSUFFICIENT_PRIVILEGES}} **現在の Windows ユーザはこの操作を実行するのに十分な権限を持っていません。管理者権限が必要です。 エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' 0 ベース インデックスを与えられるとこの関数はコンジットの登録を解除します。コンジットが通常通りの方法で登録されていた - 例えば、{{goto CmInstallSystemConduitByStruct,CmInstallSystemConduitByStruct()}} を使って - 場合、この関数はそのコンジットのすべてのコンフィグレーション エントリを削除します。しかしながら、コンジットがシステムの {{span style='color:blue;font-family:monospace;',Conduits}} フォルダに置かれていた場合、この関数はそのコンジットをシステム {{span style='color:blue;font-family:monospace;',Disabled}} フォルダに移動させます。そのためフォルダ登録コンジットに対してこの関数を呼び出すことは {{goto FmDisableSystemConduitByPath,FmDisableSystemConduitByPat()|C/C++ Sync Suite Reference601/11-3}} を呼び出すのと同じ結果となります。 この関数はシステムのためのコンジットの登録を解除します。現在の Windows ユーザのためのコンジットの登録を解除するには、{{goto CmRemoveConduitByCreatorID,CmRemoveConduitByCreatorID()}} または {{goto CmRemoveConduitByIndex,CmRemoveConduitByIndex()}} を呼び出します。 '''互換性''' *コンジット マネージャ バージョン: 3 以降 *Palm OS バージョン: すべて '''参照''' {{goto CmRemoveSystemConduitByCreatorID,CmRemoveSystemConduitByCreatorID()}}, {{goto CmRemoveConduitByIndex,CmRemoveConduitByIndex()}}, {{goto CmRemoveConduitByCreatorID,CmRemoveConduitByCreatorID()}} !{{anchor CmRestoreHotSyncSettings}}CmRestoreHotSyncSettings 関数 {{goto top,^TOP^}} '''目的''' (使用を推奨されなくなりました) HotSync マネージャ コンフィグレーション エントリ設定をデフォルト値に戻します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',CondMgr.h}} '''Prototype''' int CmRestoreHotSyncSettings ( BOOL bToDefaults ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ bToDefaults}} **{{span style='color:blue;font-family:monospace;',TRUE}} である場合、エントリを削除してデフォルトの設定を用いてエントリを再度追加します。{{span style='color:blue;font-family:monospace;',FALSE}} である場合、すでに上書きされている設定以外のエントリをデフォルト値に戻します。 '''返り値''' 成功した場合、0 を返します。 失敗した場合、以下の非 0 のエラー コード値の 1 つを返します: *{{span style='color:blue;font-family:monospace;',ERR_FOLDER_NOT_FOUND}} **{{span style='color:blue;font-family:monospace;',Conduits}} または {{span style='color:blue;font-family:monospace;',Disabled}} フォルダが存在せず、作成することもできません。 *{{span style='color:blue;font-family:monospace;',ERR_INSUFFICIENT_PRIVILEGES}} **現在の Windows ユーザはこの操作を実行するのに十分な権限を持っていません。管理者権限が必要です。 エラー コードについての更なる情報は、{{goto Conduit Manager Error Codes,「コンジット マネージャ エラー コード」|C/C++ Sync Suite Reference601/11-3}} を参照してください。 '''コメント''' CDK 6.0 では、この関数は使用を推奨されなくなり、将来のコンジット マネージャ API のバージョンでは旧式化します。 ::{{span style='color:red;font-weight:bold;',WARNING!}} **この関数を使用してはいけません。この関数を呼び出すといくつかのサード パーティ コンジットは正しく動作しなくなる可能性があります。 この関数は HotSync マネージャのための {{goto Core\HotSyncPath 3,Core\HotSyncPath|Introduction to Conduit Development601/A}} と {{goto Core\Path 3,Core\Path|Introduction to Conduit Development601/A}} コンフィグレーション エントリをデフォルト値に戻します。さらに、デフォルト コンジット (アドレス帳コンジット、予定表コンジット、To Do コンジット、メモ帳コンジット、バックアップ コンジット、インストール コンジット) と通知機能のためのコンフィグレーション エントリをリストアします。 {{span style='color:blue;font-family:monospace;',bToDefaults}} パラメータが {{span style='color:blue;font-family:monospace;',TRUE}} である場合、この関数はまずそれらの設定を削除し、デフォルト値を用いてそれらを再度追加します。これはデフォルト コンジットと他の設定はリストアされるが、他のコンジットのコンフィグレーション エントリは変更されないということを意味します。{{span style='color:blue;font-family:monospace;',bToDefaults}} が {{span style='color:blue;font-family:monospace;',FALSE}} である場合、この関数はそれらの設定をデフォルト値にリセットしますが、サード パーティの設定により上書きされているコンフィグレーション エントリは変更されません。例えば、サード パーティ コンジットがクリエイタ ID {{span style='color:blue;font-family:monospace;','date'}} で登録されている場合、{{span style='color:blue;font-family:monospace;',bToDefaults}} = {{span style='color:blue;font-family:monospace;',TRUE}} でこの関数を呼び出すとコンジットのコンフィグレーション エントリは上書きされますが、{{span style='color:blue;font-family:monospace;',bToDefaults}} = {{span style='color:blue;font-family:monospace;',FALSE}} でこの関数を呼び出すと上書きされません。 '''互換性''' *コンジット マネージャ バージョン: 2 以降 *Palm OS バージョン: すべて [[←　11 章のページ 1 へ|C/C++ Sync Suite Reference601/11-1]]　[[↑　11 章のトップへ|C/C++ Sync Suite Reference601/11]]　[[11 章のページ 3 へ　→|C/C++ Sync Suite Reference601/11-3]] {{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}}