[[←　60 章に戻る|Palm OS Programmer's API Reference/60]]　[[↑トップへ|Palm OS Programmer's API Reference]]　[[62 章に進む　→|Palm OS Programmer's API Reference/62]] ---- {{anchor top}} この章の索引 *{{goto 接続マネージャデータタイプ,接続マネージャデータタイプ}} **{{goto CncProfileID,CncProfileID}} *{{goto 接続マネージャ定数,接続マネージャ定数}} **{{goto General Profile Parameters,General Profile Parameters}} **{{goto Phone Profile Parameters,Phone Profile Parameters}} **{{goto GPRS Profile Parameters,GPRS Profile Parameters}} **{{goto Profile Parameter Sizes,Profile Parameter Sizes}} **{{goto Profile Parameter Types,Profile Parameter Types}} **{{goto Device Kinds,Device Kinds}} *{{goto 接続マネージャ関数,接続マネージャ関数}} **{{goto CncAddProfile,CncAddProfile}} **{{goto CncDefineParamID,CncDefineParamID}} **{{goto CncDeleteProfile,CncDeleteProfile}} **{{goto CncGetParamType,CncGetParamType}} **{{goto CncGetProfileInfo,CncGetProfileInfo}} **{{goto CncGetProfileList,CncGetProfileList}} **{{goto CncGetSystemFlagBitnum,CncGetSystemFlagBitnum}} **{{goto CncGetTrueParamID,CncGetTrueParamID}} **{{goto CncIsFixedLengthParamType,CncIsFixedLengthParamType}} **{{goto CncIsSystemFlags,CncIsSystemFlags}} **{{goto CncIsSystemRange,CncIsSystemRange}} **{{goto CncIsThirdPartiesRange,CncIsThirdPartiesRange}} **{{goto CncIsVariableLengthParamType,CncIsVariableLengthParamType}} **{{goto CncProfileCloseDB,CncProfileCloseDB}} **{{goto CncProfileCount,CncProfileCount}} **{{goto CncProfileCreate,CncProfileCreate}} **{{goto CncProfileDelete,CncProfileDelete}} **{{goto CncProfileGetCurrent,CncProfileGetCurrent}} **{{goto CncProfileGetIDFromIndex,CncProfileGetIDFromIndex}} **{{goto CncProfileGetIDFromName,CncProfileGetIDFromName}} **{{goto CncProfileGetIndex,CncProfileGetIndex}} **{{goto CncProfileOpenDB,CncProfileOpenDB}} **{{goto CncProfileSetCurrent,CncProfileSetCurrent}} **{{goto CncProfileSettingGet,CncProfileSettingGet}} **{{goto CncProfileSettingSet,CncProfileSettingSet}} ---- !!!61 接続マネージャ接続マネージャは、他のアプリケーションが接続パネルの中に保持される接続プロファイルへのアクセス、追加、削除することを可能にします。この章では、ヘッダファイル {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} で宣言されている接続マネージャ API のための参照資源を提供します: *{{goto 接続マネージャデータタイプ,接続マネージャデータタイプ}} *{{goto 接続マネージャ定数,接続マネージャ定数}} *{{goto 接続マネージャ関数,接続マネージャ関数}} 追加情報は、''Palm OS Programmer's Companion, vol. II'' の[[「シリアル通信」|Palm OS Programmer's Companion Volume II/5]]を参照してください。 !!{{anchor 接続マネージャデータタイプ}}接続マネージャデータタイプ {{goto top,^TOP^}} !{{anchor CncProfileID}}CncProfileID Typedef {{goto top,^TOP^}} '''目的''' {{span style='color:blue;font-family:monospace;',CncProfileID}} タイプは接続マネージャプロファイルデータベースの中の固有の接続プロファイルを特定します。この ID をいくつかの接続マネージャ関数にパラメータとして渡すことができます。接続のプロファイル ID を {{goto CncProfileGetIDFromName,CncProfileGetIDFromName()}} または {{goto CncProfileGetIDFromIndex,CncProfileGetIDFromIndex()}} を使って取得することができます。 '''Prototype''' typedef UInt32 CncProfileID; '''互換性''' {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Reference/B}} が満たされる場合にのみ、定義されます。 !!{{anchor 接続マネージャ定数}}接続マネージャ定数 {{goto top,^TOP^}} !{{anchor General Profile Parameters}}General Profile Parameters {{goto top,^TOP^}} 接続マネージャは、あらかじめインストールされている接続プロファイルの中の各パラメータを表す以下の定数を定義します。すべてのパラメータがすべてのプロファイルタイプに対して機能するわけではありません。 ,'''パラメータ名''','''パラメータタイプ''','''説明''' ,"{{span style='color:blue;font-family:monospace;',kCncParamBaud}}","{{span style='color:blue;font-family:monospace;',UInt32}}",接続に使用されるボーレート。 ,"{{span style='color:blue;font-family:monospace;',kCncParamBluetoothDeviceAddr}}",バッファ,"Bluetooth ポートを通して接続されるハンドヘルドデバイスの 48 ビットアドレス（{{span style='color:blue;font-family:monospace;',BD_ADDR}}）。このパラメータは、{{span style='color:blue;font-family:monospace;',kCncParamPort}} が Bluetooth ポートを指定する場合にのみ、有効です。" ,"{{span style='color:blue;font-family:monospace;',kCncParamBluetoothDeviceName}}",文字列,"Bluetooth ポートを通して接続されるハンドヘルドデバイスの名前。デバイス名は UTF-8 文字エンコードを使用します。このパラメータは、{{span style='color:blue;font-family:monospace;',kCncParamPort}} が Bluetooth ポートを指定する場合にのみ、有効です。" ,"{{span style='color:blue;font-family:monospace;',kCncParamCountryIndex}}","{{span style='color:blue;font-family:monospace;',UInt16}}","国名を提供する {{span style='color:blue;font-family:monospace;',kCncParamIntlModemCountryStringList}} とこのプロファイルのためのリセットコマンドを提供する {{span style='color:blue;font-family:monospace;',kCncParamIntlModemResetStringList}} によって返される文字列のリストのインデックス。" ,"{{span style='color:blue;font-family:monospace;',kCncParamDeviceKind}}","{{span style='color:blue;font-family:monospace;',UInt16}}","作成される接続のタイプ（一般のシリアル接続、モデムへの接続、電話への接続など）。この値は {{goto Device Kinds,Device Kinds}} の 1 つです。" ,"{{span style='color:blue;font-family:monospace;',kCncParamDialingMode}}","{{span style='color:blue;font-family:monospace;',UInt8}}","モデムプロファイルのためのダイアルモード。1 はパルスダイアル。0 はタッチトーン。" ,"{{span style='color:blue;font-family:monospace;',kCncParamFlowControl}}","{{span style='color:blue;font-family:monospace;',UInt16}}","フロー制御設定（ハードウェアハンドシェイク）。0 はフロー制御設定がボーレート次第で使用可能、使用不可になることを示します。この設定を選択した場合、ボーレートが 2400 より大きい場合にフロー制御がオンになります。1 はフロー制御が常にオン、2 はフロー制御が常にオフであることを示します。このパラメータは電話プロファイルには適用されません。" ,"{{span style='color:blue;font-family:monospace;',kCncParamInitString}}",文字列,"モデムと電話プロファイルのための、接続を初期化するために送られるコマンドを保持する null で終了する文字列。接続パネルは、初期化文字列をプロファイルに保存する前に、初期化文字列からすべてのキャリッジリターン（CR）または他の制御文字を削除します。" ,"{{span style='color:blue;font-family:monospace;',kCncParamIntlModemCountryStringList}}",バッファ,"モデムプロファイルのための、あり得る国のリストを保持するデータバッファ。このリストが保持する国の中では、モデムが機能でき、さらにモデムがこのプロファイルのための接続パネル詳細フォームに表示されます。選択された国はダイアル接頭辞（訳者注: 原文は dialing prefix -- 市外局番や国番号のこと）とモデムリセット文字列を制御します。{{span style='color:blue;font-family:monospace;',kCncParamCountryIndex}} パラメータはこのリストで選択される国を指定します。" ,,,"データバッファは null で終了する文字列をまとめたブロックを保持します。各文字列は国名を保持します。データバッファの最初 16 ビット（{{span style='color:blue;font-family:monospace;',UInt16}} 値）はブロックの中にどれくらいの文字列があるかを知らせます。{{goto SysFormPointerArrayToStrings,SysFormPointerArrayToStrings()|Palm OS Programmer's API Reference/54}} を使ってデータバッファを文字列の配列に変換することができます。" ,,,"このパラメータ値のサイズは可変なので、まず正確なサイズを取得するために {{span style='color:blue;font-family:monospace;',NULL}} データポインタと一緒に {{goto CncProfileSettingGet,CncProfileSettingGet()}} を呼び出す必要があります。" ,"{{span style='color:blue;font-family:monospace;',kCncParamIntlModemResetStringList}}",バッファ,"モデムプロファイルのための、あり得るリセット文字列を保持するデータバッファ。{{span style='color:blue;font-family:monospace;',kCncParamCountryIndex}} パラメータはこのリストからどのリセット文字列が使用されるかを指定します。実際に使用される文字列は {{span style='color:blue;font-family:monospace;',kCncParamResetString}} パラメータに保存されます。" ,,,"データバッファは、null で終了する文字列を一まとめにしたブロックを保持します。各文字列はリセット文字列を保持します、データバッファの最初の 16 ビット（{{span style='color:blue;font-family:monospace;',UInt16}} 値）はブロックの中にいくつの文字列があるのかを知らせます。{{goto SysFormPointerArrayToStrings,SysFormPointerArrayToStrings()|Palm OS Programmer's API Referece/54}} を使ってデータバッファを文字列の配列に変換することができます。" ,,,"このパラメータは可変サイズなので、まず {{span style='color:blue;font-family:monospace;',NULL}} データポインタと一緒に {{goto CncProfileSettingGet,CncProfileSettingGet()}} を呼び出して正確なサイズを取得しなければなりません。" ,"{{span style='color:blue;font-family:monospace;',kCncParamInvisible}}",システムフラグ,"{{span style='color:blue;font-family:monospace;',true}} の場合、プロファイルはユーザから隠されます。{{span style='color:blue;font-family:monospace;',false}} の場合、プロファイルは可視です。このパラメータは現在使用されません。" ,"{{span style='color:blue;font-family:monospace;',kCncParamLocked}}",システムフラグ,"{{span style='color:blue;font-family:monospace;',true}} の場合、プロファイルはロックされ、ユーザは編集できません。{{span style='color:blue;font-family:monospace;',false}} の場合、プロファイルは編集可能です。このパラメータは、電話プロファイルなどのプロファイルによってセットすることができ、サードパーティーのユーティリティで作成することができます。" ,"{{span style='color:blue;font-family:monospace;',kCncParamName}}",文字列,プロファイルの名前。 ,"{{span style='color:blue;font-family:monospace;',kCncParamNoDetails}}",システムフラグ,"{{span style='color:blue;font-family:monospace;',true}} の場合、プロファイルの詳細は表示されるべきではありません。{{span style='color:blue;font-family:monospace;',false}} の場合、表示させることが可能です。プロファイルの詳細は接続パネルの詳細フォームに現れるパラメータです。" ,"{{span style='color:blue;font-family:monospace;',kCncParamNonEditable}}",システムフラグ,"{{span style='color:blue;font-family:monospace;',true}} の場合、接続パネルの編集フォームはこのプロファイルのために表示を抑制されるべきです。{{span style='color:blue;font-family:monospace;',false}} の場合、編集フォームを表示させることが可能です。" ,,,"このパラメータは、{{span style='color:blue;font-family:monospace;',kCncParamLocked}} や {{span style='color:blue;font-family:monospace;',kCncParamReadOnly}} とは、ユーザが編集ボタンをタップした場合にアラートを表示させる点が異なります。他のパラメータは編集フォームが表示されるのを許可しますが、変更することは許可しません。また、編集不可のプロファイルを削除することは可能ですが、Read-only またはロックされたプロファイルを削除することはできません。" ,"{{span style='color:blue;font-family:monospace;',kCncParamPort}}","{{span style='color:blue;font-family:monospace;',UInt32}}","論理的、物理的、または仮想のポート識別子。追加情報は、[[「シリアルマネージャ」|Palm OS Programmer's API Reference/70]]の{{goto ポート定数,「ポート定数」|Palm OS Programmer's API Reference/70}}を参照してください。" ,"{{span style='color:blue;font-family:monospace;',kCncParamReadOnly}}",システムフラグ,"{{span style='color:blue;font-family:monospace;',true}} の場合、プロファイルは Read-only で編集できません。{{span style='color:blue;font-family:monospace;',false}} の場合、編集できます。このパラメータは単に Palm OS にプリ-インストールされるプロファイルによって使用されることを意図したものです。" ,"{{span style='color:blue;font-family:monospace;',kCncParamResetString}}",文字列,"モデムと電話プロファイルのためのリセット文字列。モデムプロファイルのためにはこの値は {{span style='color:blue;font-family:monospace;',kCncParamIntlModemResetStringList}} の中の文字列の 1 つになります。" ,"{{span style='color:blue;font-family:monospace;',kCncParamSerialPortFlags}}","{{span style='color:blue;font-family:monospace;',UInt32}}","電話プロファイルのためのさまざまなシリアルポートハードウェア設定に関係するビットフラグ。追加情報は、{{goto シリアル設定定数,「シリアル設定定数」|Palm OS Programmer's API Reference/70}}を参照してください。" ,"{{span style='color:blue;font-family:monospace;',kCncParamSystemFlags}}","{{span style='color:blue;font-family:monospace;',UInt32}}",すべてのシステムフラグを表しているビットフラグ。現在のところ、0 から 4 のビットが意味を持ちます。これらはそれぞれ、Read-only ビット、不可視ビット、編集不可ビット、詳細無しビット、ロックビットに対応します。 ,"{{span style='color:blue;font-family:monospace;',kCncParamTimeOut}}","{{span style='color:blue;font-family:monospace;',UInt32}}",CTS が不成立でハードウェアフロー制御がオンのときの応答待ち時間（ミリ秒）。 ,"{{span style='color:blue;font-family:monospace;',kCncParamVersion}}","{{span style='color:blue;font-family:monospace;',UInt8}}","このプロファイルが作成した接続マネージャ API のバージョン。現在のバージョン番号は {{span style='color:blue;font-family:monospace;',kCncProfileVersion}}。" ,"{{span style='color:blue;font-family:monospace;',kCncParamVolume}}","{{span style='color:blue;font-family:monospace;',UInt16}}",モデムプロファイルのためのモデムボリューム。 '''互換性''' {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、定義されます。 !{{anchor Phone Profile Parameters}}Phone Profile Parameters {{goto top,^TOP^}} '''目的''' 接続マネージャは以下の定数を、電話のためのプリ-インストールされた接続プロファイルの中の各パラメータを表すために、定義します。また、適用されるかもしれない他のパラメータ定数については、{{goto General Profile Parameters,General Profile Parameters}} と {{goto GPRS Profile Parameters,GPRS Profile Parameters}} を参照してください。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''定数''' *{{span style='color:blue;font-family:monospace;',"#define kCncParamReceiveTimeOut CncDefineParamID( kCncParamOSRange , kCncParamUInt32, 14 )"}} **電話からの応答の待ち時間であるミリ秒数を保持している {{span style='color:blue;font-family:monospace;',UInt32}}。このタイム-アウト値は、ネットワークにアクセスする必要の無い電話関数（例えば、{{goto TelNwkGetSelectedNetwork,TelNwkGetSelectedNetwork()|Palm OS Programmer's API Reference/75}}）によって使用されます。 *{{span style='color:blue;font-family:monospace;',"#define kCncParamTTCreator CncDefineParamID( kCncParamOSRange, kCncParamUInt32, 91 )"}} **電話ドライバによって使用される電話タスクの作成者 ID を保持している {{span style='color:blue;font-family:monospace;',UInt32}}。 *{{span style='color:blue;font-family:monospace;',"#define kCncParamTTType CncDefineParamID( kCncParamOSRange, kCncParamUInt32, 90 )"}} **電話ドライバによって使用される電話タスクのデータベースタイプを保持している {{span style='color:blue;font-family:monospace;',UInt32}}。 *{{span style='color:blue;font-family:monospace;',"#define kCncParam_GSM_BearerServices CncDefineParamID(kCncParamOSRange, kCncParamUInt8, 211 )"}} *{{span style='color:blue;font-family:monospace;',"#define kCncParam_GSM_ConnectionElement CncDefineParamID(kCncParamOSRange, kCncParamUInt8, 212 )"}} *{{span style='color:blue;font-family:monospace;',"#define kCncParam_GSM_Speed CncDefineParamID(kCncParamOSRange, kCncParamUInt8, 210 )"}} *{{span style='color:blue;font-family:monospace;',"#define kCncParam_PSDCreator CncDefineParamID( kCncParamOSRange, kCncParamUInt32, 93 )"}} **電話ドライバの作成者 ID を保持している {{span style='color:blue;font-family:monospace;',UInt32}}。 *{{span style='color:blue;font-family:monospace;',"#define kCncParam_PSDParameterBuffer CncDefineParamID(kCncParamOSRange, kCncParamBuffer, 100 )"}} **電話ドライバが保存しなければならないすべての必要なデータを保持しているデータバッファ。通常、このパラメータは接続パネルの詳細フォームを使ってセットされるデータを保持します。 *{{span style='color:blue;font-family:monospace;',"#define kCncParam_PSDType CncDefineParamID(kCncParamOSRange, kCncParamUInt32, 94 )"}} **電話ドライバのためのデータベースタイプを保持している {{span style='color:blue;font-family:monospace;',UInt32}}。 !{{anchor GPRS Profile Parameters}}GPRS Profile Parameters {{goto top,^TOP^}} '''目的''' 接続マネージャは以下の定数を、GPRS ネットワークのためのプリ-インストールされた接続プロファイルの中の各パラメータを表すために、定義します。また、適用されるかもしれない他のパラメータ定数については、{{goto General Profile Parameters,General Profile Parameters}} と {{goto Phone Profile Parameters,Phone Profile Parameters}} を参照してください。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''定数''' *{{span style='color:blue;font-family:monospace;',"#define kCncParam_GPRS_APNName CncDefineParamID(kCncParamOSRange, kCncParamString, 200 )"}} **GPRS アクセスポイント名（APN）を保持している文字列。 *{{span style='color:blue;font-family:monospace;',"#define kCncParam_GPRS_DataCompression CncDefineParamID(kCncParamOSRange, kCncParamUInt8, 202 )"}} **データ圧縮を示す {{span style='color:blue;font-family:monospace;',UInt8}} に保存されたブール値。 *{{span style='color:blue;font-family:monospace;',"#define kCncParam_GPRS_QOS_Delay CncDefineParamID(kCncParamOSRange, kCncParamUInt8, 204 )"}} **GPRS サービスの品質遅れ値を保持している {{span style='color:blue;font-family:monospace;',UInt8}}。 *{{span style='color:blue;font-family:monospace;',"#define kCncParam_GPRS_QOS_Mean CncDefineParamID(kCncParamOSRange, kCncParamUInt8, 207 )"}} **GPRS サービスの品質の平均スループットを保持している {{span style='color:blue;font-family:monospace;',UInt8}}。 *{{span style='color:blue;font-family:monospace;',"#define kCncParam_GPRS_QOS_Peak CncDefineParamID(kCncParamOSRange, kCncParamUInt8, 206 )"}} **GPRS サービスの品質のピークスループットを保持している {{span style='color:blue;font-family:monospace;',UInt8}}。 *{{span style='color:blue;font-family:monospace;',"#define kCncParam_GPRS_QOS_Precedence CncDefineParamID(kCncParamOSRange, kCncParamUInt8, 203 )"}} **GPRS サービスの品質の先行値を保持している {{span style='color:blue;font-family:monospace;',UInt8}}。 *{{span style='color:blue;font-family:monospace;',""#define kCncParam_GPRS_QOS_Reliability CncDefineParamID(kCncParamOSRange, kCncParamUInt8, 205 )""}} **GPRS サービスの品質の信頼性の値を保持している {{span style='color:blue;font-family:monospace;',UInt8}}。 !{{anchor Profile Parameter Sizes}}Profile Parameter Sizes {{goto top,^TOP^}} サイズ定数は {{goto General Profile Parameters,General Profile Parameters}} で説明されているあらかじめ定義された各パラメータのサイズを指定します。以下に示す表はパラメータ名、その値のサイズ、サイズを決めるサイズ定数をリストしています。これらのサイズ定数は {{goto CncProfileSettingGet,CncProfileSettingGet()}} や {{goto CncProfileSettingSet,CncProfileSettingSet()}} に渡すのに適しています。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} ,'''プロファイルパラメータ名''','''サイズ''','''サイズ定数''' ,"{{span style='color:blue;font-family:monospace;',kCncParamBaud}}",32,"{{span style='color:blue;font-family:monospace;',kCncParamBaudSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamBluetoothDeviceAddr}}",8,"{{span style='color:blue;font-family:monospace;',kCncParamBluetoothDeviceAddrSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamBluetoothDeviceName}}",249,"{{span style='color:blue;font-family:monospace;',kCncParamBluetoothDeviceNameMaxSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamCountryIndex}}",16,"{{span style='color:blue;font-family:monospace;',kCncParamCountryIndexSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamDeviceKind}}",16,"{{span style='color:blue;font-family:monospace;',kCncParamDeviceKindSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamDialingMode}}",8,"{{span style='color:blue;font-family:monospace;',kCncParamDialingModeSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamFlowControl}}",16,"{{span style='color:blue;font-family:monospace;',kCncParamFlowControlSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamInitString}}",81,"{{span style='color:blue;font-family:monospace;',kCncParamInitStringMaxSize}}" ,,81,"{{span style='color:blue;font-family:monospace;',kCncParamInitStringMaxSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamInvisible}}",8,"{{span style='color:blue;font-family:monospace;',kCncParamInvisibleSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamLocked}}",8,"{{span style='color:blue;font-family:monospace;',kCncParamLockedSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamName}}",22,"{{span style='color:blue;font-family:monospace;',kCncParamNameMaxSize}}" ,,22,"{{span style='color:blue;font-family:monospace;',kCncProfileNameSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamNoDetails}}",8,"{{span style='color:blue;font-family:monospace;',kCncParamNoDetailsSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamNonEditable}}",8,"{{span style='color:blue;font-family:monospace;',kCncParamNonEditableSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamPort}}",32,"{{span style='color:blue;font-family:monospace;',kCncParamPortSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParam_PSDCreator}}",32,"{{span style='color:blue;font-family:monospace;',kCncParam_PSDCreatorSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParam_PSDName}}",32,"{{span style='color:blue;font-family:monospace;',kCncParam_PSDNameSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParam_PSDType}}",32,"{{span style='color:blue;font-family:monospace;',kCncParam_PSDTypeSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamReadOnly}}",8,"{{span style='color:blue;font-family:monospace;',kCncParamReadOnlySize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamReceiveTimeOut}}",32,"{{span style='color:blue;font-family:monospace;',kCncParamReceiveTimeOutSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamResetString}}",81,"{{span style='color:blue;font-family:monospace;',kCncParam_PSDNameSize}}" ,,8,"{{span style='color:blue;font-family:monospace;',kCncProfileClassicResetStringSize}}" ,,81,"{{span style='color:blue;font-family:monospace;',kCncProfileUsualResetStringSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamSystemFlags}}",32,"{{span style='color:blue;font-family:monospace;',kCncParamSystemFlagsSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamTimeOut}}",32,"{{span style='color:blue;font-family:monospace;',kCncParamTimeOutSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamTTCreator}}",32,"{{span style='color:blue;font-family:monospace;',kCncParamTTCreatorSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamTTType}}",32,"{{span style='color:blue;font-family:monospace;',kCncParamTTTypeSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamVersion}}",8,"{{span style='color:blue;font-family:monospace;',kCncParamVersionSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParamVolume}}",16,"{{span style='color:blue;font-family:monospace;',kCncParamVolumeSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParam_GPRS_APNNam}}",,"{{span style='color:blue;font-family:monospace;',kCncParam_GPRS_APNNameMaxSize}}（この値は、APN 名文字列が持つかもしれない最大のサイズです。）" ,"{{span style='color:blue;font-family:monospace;',kCncParam_GPRS_DataCompression}}",8,"{{span style='color:blue;font-family:monospace;',kCncParam_GPRS_DataCompressionSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParam_GPRS_HeaderCompression}}",8,"{{span style='color:blue;font-family:monospace;',kCncParam_GPRS_HeaderCompressionSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParam_GPRS_QOS_Delay}}",8,"{{span style='color:blue;font-family:monospace;',kCncParam_GPRS_QOS_DelaySize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParam_GPRS_QOS_Mean}}",8,"{{span style='color:blue;font-family:monospace;',kCncParam_GPRS_QOS_MeanSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParam_GPRS_QOS_Peak}}",8,"{{span style='color:blue;font-family:monospace;',kCncParam_GPRS_QOS_PeakSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParam_GPRS_QOS_Precedence}}",8,"{{span style='color:blue;font-family:monospace;',kCncParam_GPRS_QOS_PrecedenceSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParam_GPRS_QOS_Reliability}}",8,"{{span style='color:blue;font-family:monospace;',kCncParam_GPRS_QOS_ReliabilitySize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParam_GSM_BearerServices}}",8,"{{span style='color:blue;font-family:monospace;',kCncParam_GSM_BearerServicesSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParam_GSM_ConnectionElement}}",8,"{{span style='color:blue;font-family:monospace;',kCncParam_GSM_BearerServicesSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParam_GSM_ConnectionElement}}",8,"{{span style='color:blue;font-family:monospace;',kCncParam_GSM_ConnectionElementSize}}" ,"{{span style='color:blue;font-family:monospace;',kCncParam_GSM_Speed}}",8,"{{span style='color:blue;font-family:monospace;',kCncParam_GSM_SpeedSize}}" '''互換性''' {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、定義されます。 !{{anchor Profile Parameter Types}}Profile Parameter Types {{goto top,^TOP^}} パラメータタイプ定数は接続プロファイルの中のパラメータに保存される値のタイプを指定します。{{goto CncDefineParamID,CncDefineParamID()}} を使って新しいパラメータを定義する場合、これらの定数の 1 つを使ってパラメータが保存するデータのタイプを指定しなければなりません。マクロ {{goto CncGetParamType,CncGetParamType()}} がプロファイルの中のいずれかのパラメータのためのこの情報を返すことができます。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''定数''' *{{span style='color:blue;font-family:monospace;',"#define kCncParamBuffer CncDefineParameterType(kCncParamVariableLen, 2)"}} **データの一般的なブロック *{{span style='color:blue;font-family:monospace;',"#define kCncParamString CncDefineParameterType(kCncParamVariableLen, 1)"}} **文字列パラメータ *{{span style='color:blue;font-family:monospace;',"#define kCncParamSystemFlag CncDefineParameterType(kCncParamFixedLen, 0)"}} **システムフラグパラメータ。接続マネージャは最大 32個のシステムフラグを保存することができます。フラグは 1 つのビットの中に保存され {{span style='color:blue;font-family:monospace;',UInt8}} 値として返されます。システムフラグワード全体は、{{goto CncProfileSettingGet,CncProfileSettingGet()}} に {{span style='color:blue;font-family:monospace;',kCncParamSystemFlags }}を渡した場合に、返されます。 *{{span style='color:blue;font-family:monospace;',"#define kCncParamUInt16 CncDefineParameterType(kCncParamFixedLen, 2)"}} **{{span style='color:blue;font-family:monospace;',UInt16}} パラメータ *{{span style='color:blue;font-family:monospace;',"#define kCncParamUInt32 CncDefineParameterType(kCncParamFixedLen, 3)"}} **{{span style='color:blue;font-family:monospace;',UInt32}} パラメータ *{{span style='color:blue;font-family:monospace;',"#define kCncParamUInt8 CncDefineParameterType(kCncParamFixedLen, 1)"}} **{{span style='color:blue;font-family:monospace;',UInt8}} パラメータ '''互換性''' {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、定義されます。 !{{anchor Device Kinds}}Device Kinds {{goto top,^TOP^}} '''目的''' デバイス種類の定数は行われる接続のタイプを指定します。接続のタイプを、{{goto CncProfileSettingSet,CncProfileSettingSet()}} を使って {{span style='color:blue;font-family:monospace;',kCncParamDeviceKind}} の値を定義することによって、指定します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''定数''' *{{span style='color:blue;font-family:monospace;',"#define kCncDeviceKindGPRS 4"}} **GPRS ネットワークへの接続 *{{span style='color:blue;font-family:monospace;',"#define kCncDeviceKindGSM 5"}} **GSM 電話への接続 *{{span style='color:blue;font-family:monospace;',"#define kCncDeviceKindLocalNetwork 3"}} **LAN への接続 *{{span style='color:blue;font-family:monospace;',"#define kCncDeviceKindModem 1"}} **モデムへの接続 *{{span style='color:blue;font-family:monospace;',"#define kCncDeviceKindPhone 2"}} **電話への接続 *{{span style='color:blue;font-family:monospace;',"#define kCncDeviceKindSerial 0"}} **シリアルポートを通しての接続 '''互換性''' {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、定義されます。 !!{{anchor 接続マネージャ関数}}接続マネージャ関数 {{goto top,^TOP^}} !{{anchor CncAddProfile}}CncAddProfile 関数 {{goto top,^TOP^}} '''目的''' 接続マネージャにプロファイルを追加します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' Err CncAddProfile ( Char *name, UInt32 port, UInt32 baud, UInt16 volume, UInt16 handShake, const Char *initString, const Char *resetString, Boolean isModem, Boolean isPulse ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',←→ name}} **追加するプロファイル名へのポインタ。名前がすでに接続パネルにある場合、重複番号が追加されます。追加された名前はここに返されます。 *{{span style='color:blue;font-family:monospace;',→ port}} **プロファイルによって使用されるポート識別子。追加情報については、''Palm OS Programmer's Companion, vol. II'' 「通信」の{{goto ポートの指定,ポートの指定|Palm OS Programmer's Companion Volume II/5-4}} を参照してください。 *{{span style='color:blue;font-family:monospace;',→ baud}} **プロファイルによって使用されるボーレート。 *{{span style='color:blue;font-family:monospace;',→ volume}} **デバイスのためのボリューム設定（モデムのみ） *{{span style='color:blue;font-family:monospace;',→ handShake}} **フロー制御設定（ハードウェアハンドシェイク）。0 は自動（2400 ボーを超えるスピードでオン）を指定し、1 は常にオンを指定し、2 は常にオフを指定します。 *{{span style='color:blue;font-family:monospace;',→ initString}} **モデムによって使用される初期化文字列へのポインタ（モデムのみ）。 *{{span style='color:blue;font-family:monospace;',→ resetString}} **モデムによって使用されるリセット文字列へのポインタ（モデムのみ）。 *{{span style='color:blue;font-family:monospace;',→ isModem}} **モデム接続の場合 {{span style='color:blue;font-family:monospace;',true}}。直接の場合 {{span style='color:blue;font-family:monospace;',false}}。 *{{span style='color:blue;font-family:monospace;',→ isPulse}} **パルスダイアルの場合 {{span style='color:blue;font-family:monospace;',true}}。タッチトーンの場合 {{span style='color:blue;font-family:monospace;',false}}。 '''返り値''' *{{span style='color:blue;font-family:monospace;',errNone}} **エラー無し *{{span style='color:blue;font-family:monospace;',cncErrAddProfileFailed}} **追加操作が失敗 *{{span style='color:blue;font-family:monospace;',cncErrProfileListFull}} **プロファイルリストが満杯のため、追加操作が失敗 *{{span style='color:blue;font-family:monospace;',cncErrConDBNotFound}} **接続データベースが見つからない '''コメント''' 接続マネージャのすべてのプロファイルは固有の名前を持たなくてはなりません。指定した名前がすでに使用されている場合、接続マネージャは名前の最後に重複番号を追加しようと試みます。接続マネージャによって維持されるプロファイルの数には限度があります。限度を超えてプロファイルの追加をした場合、エラーが返され、プロファイルは追加されません。ある特定のフィールドを必要としないプロファイルは、そのフィールドの値として {{span style='color:blue;font-family:monospace;',NULL}} を渡すかもしれません。 '''互換性''' {{goto New Serial Manager Feature Set,New Serial Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、実装されます。 {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合、この関数を使用する代わりに {{goto CncProfileCreate,CncProfileCreate()}} を使用します。{{span style='color:blue;font-family:monospace;',CncAddProfile}} の下位互換はまだサポートされています。Palm OS 4.0 以降では、定義できるプロファイルの最大数はかなり増加しました。 '''例''' {{span_begin style='font-family:monospace;'}}AddMyProfile() { Char *myConNameP; Err err; myConNameP = MemPtrNew(cncProfileNameSize); StrCopy(myConNameP, "Foobar"); err = CncAddProfile(myConNameP, 'u328', 57600, 0, 0, "AT&FX4", 0, true, false); MemPtrFree(myConNameP); }{{span_end}} !{{anchor CncDefineParamID}}CncDefineParamID マクロ {{goto top,^TOP^}} '''目的''' パラメータ ID を作成し、返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' #define CncDefineParamID ( parameterRange, parameterType, parameterID ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ parameterRange}} **このパラメータが OS によって定義されたものではないことを示すために {{span style='color:blue;font-family:monospace;',kCncParamThirdPartiesRange}} を使用します。 *{{span style='color:blue;font-family:monospace;',→ parameterType}} **パラメータに保存される値のタイプ。とり得る値のリストについては、{{goto Profile Parameter Types,Profile Parameter Types}} を参照してください。 *{{span style='color:blue;font-family:monospace;',→ parameterID}} **0 から 1023 までの固有の値。この値はパラメータを定義しようとしているプロファイル内で固有でなければなりません。{{br}}{{span style='color:blue;font-family:monospace;',kCncParamSystemFlag}} の {{span style='color:blue;font-family:monospace;',parameterType}} を使用している場合、どのシステムフラグビットがセットされるのかを指定するために 0 から 31 までの値を指定してください。 '''返り値''' パラメータ ID を {{span style='color:blue;font-family:monospace;',UInt16}} 値として返します。 '''コメント''' 接続プロファイルを定義していて、そのプロファイルの中に定義する必要のあるパラメータがある場合にのみ、このマクロを使用します。パラメータ ID はすぐに、接続マネージャプロファイルデータベースのパラメータ値に先行します。データベースのフォーマットの仕方にはいくつかあるため、パラメータ ID は接続マネージャに後に続く一連のバイトをどのように解釈すべきか知らせる必要があります。この理由から、パラメータ ID の上位ビットは、値のタイプと値がシステムによって定義されるのか、それともサードパーティによって定義されるのかについての情報を含みます。 '''互換性''' このフォーマットのパラメータ ID は、{{goto 4.0 New Feature Set,4.0 New Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、使用されます。 '''参照''' {{goto CncProfileSettingSet,CncProfileSettingSet()}}, {{goto CncProfileSettingGet,CncProfileSettingGet()}} !{{anchor CncDeleteProfile}}CncDeleteProfile 関数 {{goto top,^TOP^}} '''目的''' プロファイルを接続マネージャから削除します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' Err CncDeleteProfile ( const Char *name ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ name}} **削除されるプロファイルの名前へのポインタ '''返り値''' *{{span style='color:blue;font-family:monospace;',errNone}} **エラーはありません。 *{{span style='color:blue;font-family:monospace;',cncErrProfileReadOnly}} **プロファイルは Read-only であるため、削除できませんでした。 *{{span style='color:blue;font-family:monospace;',cncErrProfileNotFound}} **プロファイルが見つかりませんでした。 *{{span style='color:blue;font-family:monospace;',cncErrConDBNotFound}} **接続データベースが見つかりません。 '''コメント''' ユニット上にプリ-インストールされたプロファイルは Read-only で、削除することはできません。 '''互換性''' {{goto New Serial Manager Feature Set,New Serial Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、定義されます。 {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合、この関数の代わりに {{goto CncProfileDelete,CncProfileDelete()}} を使用してください。 !{{anchor CncGetParamType}}CncGetParamType マクロ {{goto top,^TOP^}} '''目的''' パラメータ ID の一部であるパラメータタイプを返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' #define CncGetParamType ( parameterID ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ parameterID}} **パラメータ ID を保持する {{span style='color:blue;font-family:monospace;',UInt16}} '''返り値''' ビット 11 から 14 までが {{goto Profile Parameter Types,Profile Parameter Types}} の中の値の 1 つを保持し、他のビットはクリアされている {{span style='color:blue;font-family:monospace;',UInt16}} を返します。 '''互換性''' このフォーマットのパラメータ ID は、{{goto 4.0 New Feature Set,4.0 New Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、使用されます。 '''参照''' {{goto CncProfileSettingSet,CncProfileSettingSet()}}, {{goto CncProfileSettingGet,CncProfileSettingGet()}} !{{anchor CncGetProfileInfo}}CncGetProfileInfo 関数 {{goto top,^TOP^}} '''目的''' プロファイルの設定を返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' Err CncGetProfileInfo ( Char *name, UInt32 *port, UInt32 *baud, UInt16 *volume, UInt16 *handShake, Char *initString, Char *resetString, Boolean *isModem, Boolean *isPulse ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ name}} **返されるプロファイルの名前へのポインタ。このパラメータに {{span style='color:blue;font-family:monospace;',NULL}} を渡すと、この関数は現在接続パネルで選択されているプロファイルの設定を返します。 *{{span style='color:blue;font-family:monospace;',← port}} **プロファイルが使用しているポート識別子へのポインタ *{{span style='color:blue;font-family:monospace;',← baud}} **このプロファイルにセットされているボーレートへのポインタ *{{span style='color:blue;font-family:monospace;',← volume}} **デバイスのボリュームへのポインタ（モデムに対してのみ適用されます） *{{span style='color:blue;font-family:monospace;',← handShake}} **フロー制御設定（ハードウェアハンドシェイク）へのポインタ。0 は自動（2400 ボーを超えるスピードでオン）を示し、1 は常にオン、2 は常にオフを示します。 *{{span style='color:blue;font-family:monospace;',← initString}} **デバイスのための初期化文字列へのポインタ（モデムに対してのみ適用されます） *{{span style='color:blue;font-family:monospace;',← resetString}} **デバイスのためのリセット文字列へのポインタ（モデムに対してのみ適用されます） *{{span style='color:blue;font-family:monospace;',← isModem}} **ブール値へのポインタ: {{span style='color:blue;font-family:monospace;',true}} はモデムを通しての接続、{{span style='color:blue;font-family:monospace;',false}} は直接接続を意味します。 *{{span style='color:blue;font-family:monospace;',← isPulse}} **ブール値へのポインタ: {{span style='color:blue;font-family:monospace;',true}} はパルスダイアル、{{span style='color:blue;font-family:monospace;',false}} はタッチトーンを意味します。 '''返り値''' *{{span style='color:blue;font-family:monospace;',errNone}} **エラーはありません。 *{{span style='color:blue;font-family:monospace;',cncErrGetProfileFailed}} **プロファイル取得操作が失敗しました。プロファイルはそこにあるかもしれませんし、ないかもしれません。 *{{span style='color:blue;font-family:monospace;',cncErrProfileNotFound}} **プロファイルが見つかりませんでした。 *{{span style='color:blue;font-family:monospace;',cncErrConDBNotFound}} **接続データベースが見つかりません。 '''コメント''' 取得する必要のない情報がある場合、1 つ以上のパラメータに {{span style='color:blue;font-family:monospace;',NULL}} をセットするかもしれません。 '''互換性''' {{goto New Serial Feature Set,New Serial Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、実装されます。 {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合、この関数を使用する代わりに {{goto General Profile Parameters,General Profile Parameters}} の 1 つと一緒に {{goto CncProfileSettingGet,CncProfileSettingGet()}} を使用してください。 '''例''' {{span_begin style='font-family:monospace;'}}{ UInt32 portID, baud; UInt16 openPort; // get port id err = CncGetProfileInfo("Direct Serial", &portID, &baud, 0, 0, 0, 0, 0, 0); if(!err) { // open the port SrmOpen(portID, baud, &openPort); } }{{span_end}] !{{anchor CncGetProfileList}}CncGetProfileList 関数 {{goto top,^TOP^}} '''目的''' 接続マネージャを通して使用可能なプロファイルのリストを返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' Err CncGetProfileList ( Char ***nameListPPP, UInt16 *countP ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',← nameListPPP}} **プロファイル名のリストへのポインタへのポインタ *{{span style='color:blue;font-family:monospace;',← countP}} **プロファイル名の番号へのポインタ '''返り値''' *{{span style='color:blue;font-family:monospace;',errNone}} **エラーはありません。 *{{span style='color:blue;font-family:monospace;',cncErrGetProfileListFailed}} **プロファイルリストが見つかりませんでした。 *{{span style='color:blue;font-family:monospace;',cncErrConDBNotFound}} **接続データベースが見つかりません。 '''コメント''' リストの割り当ては接続マネージャによってハンドルされます。割り当て解除は呼び出したアプリケーションに責任があります。リストの中で最後に "-Current-" が追加されたプロファイルは、そのプロファイルが現在接続パネルで選択されているプロファイルであることを表します。 '''例''' {{span_begin style='font-family:monospace;'}}//Declared globally Char **globalProfileList; ListType *listP; UInt16 globalProfileCount; void SetConnectionList() { //Get the list from the Connection Manager err = CncGetProfileList(&globalProfileList, &globalProfileCount); //Set the UI list LstSetListChoices(listP, globalProfileList, globalProfileCount); } void StopApplication() { UInt16 i; //Deallocate the connection list For(i = 0; i < globalProfileCount; i++) MemPtrFree(globalProfileList[ i ]); MemPtrFree(globalProfileList); }{{span_end}} !{{anchor CncGetSystemFlagBitnum}}CncGetSystemFlagBitnum マクロ {{goto top,^TOP^}} '''目的''' システムフラグパラメータを一意に識別する数を返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' #define CncGetSystemFlagBitnum ( parameterID ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ parameterID}} **パラメータ ID を保持している {{span style='color:blue;font-family:monospace;',UInt16}} '''返り値''' システムフラグパラメータの ID を返します。この値は 0 から 31 までの値です。 '''参照''' {{goto CncProfileSettingSet,CncProfileSettingSet()}}, {{goto CncProfileSettingGet,CncProfileSettingGet()}} !{{anchor CncGetTrueParamID}}CncGetTrueParamID マクロ {{goto top,^TOP^}} '''目的''' パラメータを一意に識別するパラメータ ID の一部を返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' #define CncGetTrueParamID ( parameterID ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ parameterID}} **パラメータ ID を保持している {{span style='color:blue;font-family:monospace;',UInt16}} '''返り値''' 単にパラメータ ID を保持している {{span style='color:blue;font-family:monospace;',UInt16}} を返します。パラメータタイプとアドレス空間を指定する上位ビットはクリアされます。 '''互換性''' このフォーマットのパラメータ ID は、{{goto New Serial Feature Set,New Serial Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、使用されます。 '''参照''' {{goto CncProfileSettingSet,CncProfileSettingSet()}}, {{goto CncProfileSettingGet,CncProfileSettingGet()}} !{{anchor CncIsFixedLengthParamType}}CncIsFixedLengthParamType マクロ {{goto top,^TOP^}} '''目的''' パラメータ値が固定長か可変長かを識別します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' #define CncIsFixedLengthParamType ( parameterID ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ parameterID}} **パラメータ ID を保持している {{span style='color:blue;font-family:monospace;',UInt16}} '''返り値''' パラメータが {{span style='color:blue;font-family:monospace;',UInt32}} などの固定長パラメータタイプである場合 {{span style='color:blue;font-family:monospace;',true}} を返します。可変長タイプである場合 {{span style='color:blue;font-family:monospace;',false}} を返します。 '''互換性''' このフォーマットのパラメータ ID は、{{goto New Serial Feature Set,New Serial Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、使用されます。 '''参照''' {{goto CncProfileSettingSet,CncProfileSettingSet()}}, {{goto CncProfileSettingGet,CncProfileSettingGet()}} !{{anchor CncIsSystemFlags}}CncIsSystemFlags マクロ {{goto top,^TOP^}} '''目的''' パラメータ値がシステムフラグかどうかを返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' #define CncIsSystemFlags ( parameterID ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ parameterID}} **パラメータ ID を保持している {{span style='color:blue;font-family:monospace;',UInt16}} '''返り値''' パラメータタイプがシステムフラグである場合 {{span style='color:blue;font-family:monospace;',true}} を返します。そうでない場合 {{span style='color:blue;font-family:monospace;',false}} を返します。 '''互換性''' このフォーマットのパラメータ ID は、{{goto New Serial Feature Set,New Serial Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、使用されます。 '''参照''' {{goto CncProfileSettingSet,CncProfileSettingSet()}}, {{goto CncProfileSettingGet,CncProfileSettingGet()}} !{{anchor CncIsSystemRange}}CncIsSystemRange マクロ {{goto top,^TOP^}} '''目的''' パラメータがシステムによって定義されたのか、サードパーティによって定義されたのかを識別します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' #define CncIsSystemRange ( parameterID ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ parameterID}} **パラメータ ID を保持している {{span style='color:blue;font-family:monospace;',UInt16}} '''返り値''' パラメータ ID が Palm OS によって定義されている場合 {{span style='color:blue;font-family:monospace;',true}} を返します。サードパーティによって定義されている場合 {{span style='color:blue;font-family:monospace;',false}} を返します。 '''互換性''' このフォーマットのパラメータ ID は、{{goto New Serial Feature Set,New Serial Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、使用されます。 '''参照''' {{goto CncProfileSettingSet,CncProfileSettingSet()}}, {{goto CncProfileSettingGet,CncProfileSettingGet()}} !{{anchor CncIsThirdPartiesRange}}CncIsThirdPartiesRange マクロ {{goto top,^TOP^}} '''目的''' パラメータがサードパーティによって定義されたのかを識別します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' #define CncIsThirdPartiesRange ( parameterID ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ parameterID}} **パラメータ ID を保持している {{span style='color:blue;font-family:monospace;',UInt16}} '''返り値''' パラメータ ID がサードパーティによって定義されている場合 {{span style='color:blue;font-family:monospace;',true}} を返します。Palm OS によって定義されている場合 {{span style='color:blue;font-family:monospace;',false}} を返します。 '''互換性''' このフォーマットのパラメータ ID は、{{goto New Serial Feature Set,New Serial Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、使用されます。 '''参照''' {{goto CncProfileSettingSet,CncProfileSettingSet()}}, {{goto CncProfileSettingGet,CncProfileSettingGet()}} !{{anchor CncIsVariableLengthParamType}}CncIsVariableLengthParamType マクロ {{goto top,^TOP^}} '''目的''' パラメータ値が可変長タイプかどうかを返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' #define CncIsVariableLengthParamType ( parameterID ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ parameterID}} **パラメータ ID を保持している {{span style='color:blue;font-family:monospace;',UInt16}} '''返り値''' パラメータが可変長文字列またはバッファの場合 {{span style='color:blue;font-family:monospace;',true}} を返します。パラメータが整数などの固定長タイプを保持する場合 {{span style='color:blue;font-family:monospace;',false}} を返します。 '''互換性''' このフォーマットのパラメータ ID は、{{goto New Serial Feature Set,New Serial Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、使用されます。 '''参照''' {{goto CncProfileSettingSet,CncProfileSettingSet()}}, {{goto CncProfileSettingGet,CncProfileSettingGet()}} !{{anchor CncProfileCloseDB}}CncProfileCloseDB 関数 {{goto top,^TOP^}} '''目的''' 接続マネージャプロファイルデータベースをクローズします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' Err CncProfileCloseDB ( void ) '''パラメータ''' ありません。 '''返り値''' *{{span style='color:blue;font-family:monospace;',errNone}} **エラーはありません。 *{{span style='color:blue;font-family:monospace;',kCncErrDBAccessFailed}} **データベースをクローズすることができなかった、または、参照カウントエラーです。 '''コメント''' いくつかの接続マネージャ呼び出しを作成している場合、最適化として {{goto CncProfileOpenDB,CncProfileOpenDB()}} と {{span style='color:blue;font-family:monospace;',CncProfileCloseDB}} を使用します。すべての接続マネージャ呼び出しは、開始時にプロファイルデータベースをオープンし、終了時にクローズします。接続マネージャは、データベースがオープンされているかどうかを知らせる参照カウンタを維持します。他の接続マネージャを呼び出す前に {{span style='color:blue;font-family:monospace;',CncProfileOpenDB}} を呼び出した場合、次に呼び出された接続マネージャはそのデータベースをオープンしたり、クローズすることはありません。これは作成するアプリケーションの、プロファイルデータベースをオープンまたはクローズするときの、オーバヘッドを減らします。 '''互換性''' {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、実装されます。 !{{anchor CncProfileCount}}CncProfileCount 関数 {{goto top,^TOP^}} '''目的''' 接続マネージャプロファイルデータベースの中で現在定義されている接続プロファイルの番号を返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' Err CncProfileCount ( UInt16 *profilesCountP ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',← profilesCountP}} **プロファイルの番号 '''返り値''' *{{span style='color:blue;font-family:monospace;',errNone}} **エラーはありません。 *{{span style='color:blue;font-family:monospace;',kCncErrDBAccessFailed }} **プロファイルデータベースをオープンすることができませんでした。 '''互換性''' {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、実装されます。 '''参照''' {{goto CncGetProfileList,CncGetProfileList()}} !{{anchor CncProfileCreate}}CncProfileCreate 関数 {{goto top,^TOP^}} '''目的''' プロファイルレコードを接続マネージャプロファイルデータベースに追加します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' Err CncProfileCreate ( CncProfileID *profileIdP ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',← profileIdP}} **返り時に、新しいプロファイルの固有の ID を保持します。 '''返り値''' *{{span style='color:blue;font-family:monospace;',errNone}} **エラーはありません。 *{{span style='color:blue;font-family:monospace;',kCncErrDBAccessFailed}} **プロファイルデータベースをオープンすることができませんでした。 *{{span style='color:blue;font-family:monospace;',a Data Manager error}} **新しいレコードを作製することができませんでした。 '''コメント''' この関数は新しい空のレコードを接続マネージャプロファイルデータベースの中に作成します。プロファイルを実装するために、{{goto CncProfileSettingSet,CncProfileSettingSet()}} を使ってプロファイル名を含むパラメータ値をセットします。作成したプロファイルに固有の情報を保存する場合、{{goto CncDefinePraramID,CncDefineParamID()}} を使用してください。 '''互換性''' {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、実装されます。 '''参照''' {{goto CncAddProfile,CncAddProfile()}}, {{goto CncProfileDelete,CncProfileDelete()}} !{{anchor CncProfileDelete}}CncProfileDelete 関数 {{goto top,^TOP^}} '''目的''' プロファイルを削除します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' Err CncProfileDelete ( CncProfileID profileId ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',profileId}} **削除するプロファイルの ID '''返り値''' *{{span style='color:blue;font-family:monospace;',errNone}} **エラーはありません。 *{{span style='color:blue;font-family:monospace;',kCncErrDBAccessFailed}} **プロファイルデータベースをオープンすることができませんでした。または、レコードを削除することができませんでした。 *{{span style='color:blue;font-family:monospace;',kCncErrProfileParamNotFound }} **データベースは指定された ID を持つプロファイルを保持していません。 '''コメント''' ユニット上にプリ-インストールされているプロファイルは Read-only で削除することはできません。 '''互換性''' {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、実装されます。 '''参照''' {{goto CncDeleteProfile,CncDeleteProfile()}}, {{goto CncProfileCreate,CncProfileCreate()}} !{{anchor CncProfileGetCurrent}}CncProfileGetCurrent 関数 {{goto top,^TOP^}} '''目的''' 接続パネルの中で現在選択されているプロファイルの ID を返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' Err CncProfileGetCurrent( CncProfileID *profileIdP ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',← profileId}} **現在選択されているプロファイルの ID '''返り値''' *{{span style='color:blue;font-family:monospace;',errNone}} **エラーはありません。 *{{span style='color:blue;font-family:monospace;',kCncErrDBAccessFailed}} **プロファイルデータベースをオープンすることができませんでした。 '''互換性''' {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、実装されます。 '''参照''' {{goto CncProfileGetIDFromIndex,CncProfileGetIDFromIndex()}}, {{goto CncProfileGetIDFromName,CncProfileGetIDFromName()}}, {{goto CncProfileGetIndex,CncProfileGetIndex()}}, {{goto CncProfileSetCurrent,CncProfileSetCurrent()}} !{{anchor CncProfileGetIDFromIndex}}CncProfileGetIDFromIndex 関数 {{goto top,^TOP^}} '''目的''' 与えられた接続マネージャプロファイルデータベースへのインデックスを持つプロファイル ID を返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' Err CncProfileGetIDFromIndex ( UInt16 index, CncProfileID *profileIdP ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ index}} **接続マネージャプロファイルのインデックス *{{span style='color:blue;font-family:monospace;',← profileIdP}} **接続マネージャプロファイルの ID '''返り値''' *{{span style='color:blue;font-family:monospace;',errNone}} **エラーはありません。 *{{span style='color:blue;font-family:monospace;',kCncErrDBAccessFailed}} **プロファイルデータベースをオープンすることができませんでした。 *{{span style='color:blue;font-family:monospace;',kCncErrProfileParamNotFound}} **指定されたインデックスを持つプロファイルはありません。 '''互換性''' {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、実装されます。 '''参照''' {[goto CncProfileGetIDFromName,CncProfileGetIDFromName()}}, {[goto CncProfileGetCurrent,CncProfileGetCurrent()}}, {{goto CncProfileGetIndex,CncProfileGetIndex()}} !{{anchor CncProfileGetIDFromName}}CncProfileGetIDFromName 関数 {{goto top,^TOP^}} '''目的''' 与えられた名前を持つプロファイル ID を返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' Err CncProfileGetIDFromName( const Char *profileNameP, CncProfileID *profileIdP ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ profileNameP}} **プロファイルの名前。名前は接続パネルの中のポップアップリストの中に表示されます。文字列 "-Current-" を渡した場合、この関数は現在選択されているプロファイルの ID を返します。 *{{span style='color:blue;font-family:monospace;',← profileIdP}} **プロファイルの ID '''返り値''' *{{span style='color:blue;font-family:monospace;',errNone}} **エラーはありません。 *{{span style='color:blue;font-family:monospace;',kCncErrDBAccessFailed}} **プロファイルデータベースをオープンすることができませんでした。 *{{span style='color:blue;font-family:monospace;',kCncErrProfileParamNotFound}} **指定された名前を持つプロファイルはありません。 '''互換性''' {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、実装されます。 '''参照''' {[goto CncProfileGetCurrent,CncProfileGetCurrent()}}, {[goto CncProfileGetIDFromIndex,CncProfileGetIDFromIndex()}}, {{goto CncProfileGetIndex,CncProfileGetIndex()}} !{{anchor CncProfileGetIndex}}CncProfileGetIndex 関数 {{goto top,^TOP^}} '''目的''' 与えられた ID を持つプロファイルのインデックスを返します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' Err CncProfileGetIndex ( CncProfileID profileId, UInt16 *indexP ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ profileId}} **プロファイル ID *{{span style='color:blue;font-family:monospace;',← indexP}} **接続マネージャプロファイルデータベースの中のプロファイルのレコードのインデックス '''返り値''' *{{span style='color:blue;font-family:monospace;',errNone}} **エラーはありません。 *{{span style='color:blue;font-family:monospace;',kCncErrDBAccessFailed}} **プロファイルデータベースをオープンすることができませんでした。 *{{span style='color:blue;font-family:monospace;',kCncErrProfileParamNotFound}} **指定された ID を持つプロファイルはありません。 '''互換性''' {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、実装されます。 '''参照''' {{goto CncProfileGetIDFromIndex,CncProfileGetIDFromIndex()}} !{{anchor CncProfileOpenDB}}CncProfileOpenDB 関数 {{goto top,^TOP^}} '''目的''' 接続マネージャプロファイルデータベースをオープンします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' Err CncProfileOpenDB ( void ) '''パラメータ''' ありません。 '''返り値''' *{{span style='color:blue;font-family:monospace;',errNone}} **エラーはありません。 *{{span style='color:blue;font-family:monospace;',kCncErrDBAccessFailed}} **プロファイルデータベースをオープンすることができませんでした。 '''コメント''' いくつかの接続マネージャ呼び出しを作成している場合、最適化として {{span style='color:blue;font-family:monospace;',CncProfileOpenDB}} と {{goto CncProfileCloseDB,CncProfileCloseDB()}} を使用します。すべての接続マネージャ呼び出しは、開始時にプロファイルデータベースをオープンし、終了時にクローズします。接続マネージャは、データベースがオープンされているかどうかを知らせる参照カウンタを維持します。他の接続マネージャを呼び出す前に {{span style='color:blue;font-family:monospace;',CncProfileOpenDB}} を呼び出した場合、次に呼び出された接続マネージャはそのデータベースをオープンしたり、クローズすることはありません。これは作成するアプリケーションの、プロファイルデータベースをオープンまたはクローズするときの、オーバヘッドを減らします。 '''互換性''' {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、実装されます。 !{{anchor CncProfileSetCurrent}}CncProfileSetCurrent 関数 {{goto top,^TOP^}} '''目的''' 現在の（訳者補足: 選択されている）プロファイルをセットします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' Err CncProfileSetCurrent ( CncProfileID profileId ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ profileId}} **現在のプロファイルにされるプロファイルの ID。 '''返り値''' *{{span style='color:blue;font-family:monospace;',errNone}} **エラーはありません。 *{{span style='color:blue;font-family:monospace;',kCncErrDBAccessFailed}} **プロファイルデータベースをオープンすることができませんでした。 '''コメント''' 現在のプロファイルは次にネットワーク接続を試みるときに使用されるプロファイルです。 '''互換性''' {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、実装されます。 '''参照''' {{goto CncProfileGetCurrent,CncProfileGetCurrent()}} !{{anchor CncProfileSettingGet}}CncProfileSettingGet 関数 {{goto top,^TOP^}} '''目的''' 接続マネージャプロファイルの 1 つの中に保存されている値を取得します。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' Err CncProfileSettingGet ( CncProfileID profileId, UInt16 paramId, void *paramBufferP, UInt16 *ioParamSizeP ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ profileId}} **パラメータ値を取得するプロファイルの ID。 *{{span style='color:blue;font-family:monospace;',→ paramId}} **取得するパラメータの ID。デバイス上にプリ-インストールされたプロファイルの中で使用されるパラメータのリストは、{{goto General Profile Parameters,General Profile Parameters}} を参照してください。 *{{span style='color:blue;font-family:monospace;',← paramBufferP}} **パラメータ値が書き込まれるバッファへのポインタ。パラメータが可変サイズの値に保存されている場合、{{span style='color:blue;font-family:monospace;',paramBufferP}} に {{span style='color:blue;font-family:monospace;',NULL}} を渡すことで必要なサイズを決定することができます。返り時に、{{span style='color:blue;font-family:monospace;',ioParamSizeP}}（訳者注: 原文では {{span style='color:blue;font-family:monospace;',paramSize}} だが誤りと思われる）が要求されるサイズを保持します。 *{{span style='color:blue;font-family:monospace;',←→ ioParamSizeP}} **入力時には、パラメータ値が書き込まれるバッファのサイズへのポインタです。出力時には、{{span style='color:blue;font-family:monospace;',paramBufferP}} に書き込まれたバイト数へのポインタです。 '''返り値''' *{{span style='color:blue;font-family:monospace;',errNone}} **エラーはありません。 *{{span style='color:blue;font-family:monospace;',kCncErrDBAccessFailed}} **プロファイルデータベースをオープンすることができませんでした。 *{{span style='color:blue;font-family:monospace;',kCncErrProfileGetParamFailed}} **接続マネージャはパラメータの値を取得するのに失敗しました。 *{{span style='color:blue;font-family:monospace;',kCncErrProfileBadSystemFlagBitnum}} **定義されていないシステムフラグの値を取得しようとしました。 *{{span style='color:blue;font-family:monospace;',kCncErrProfileBadParamSize}} **{{span style='color:blue;font-family:monospace;',paramBufferP}} バッファが小さすぎます。{{span style='color:blue;font-family:monospace;',ioParamSizeP}} がバッファの正確なサイズを保持しています。 *{{span style='color:blue;font-family:monospace;',kCncErrProfileParamNotFound}} **指定されたパラメータはプロファイルの中で定義されていません。 '''互換性''' {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、実装されます。 '''参照''' {{goto CncProfileSettingSet,CncProfileSettingSet()}}, {{goto CncGetProfileInfo,CncGetProfileInfo()}} !{{anchor CncProfileSettingSet}}CncProfileSettingSet 関数 {{goto top,^TOP^}} '''目的''' 指定されたプロファイルの中の 1 つの値をセットします。 '''宣言されている場所''' {{span style='color:blue;font-family:monospace;',ConnectionMgr.h}} '''Prototype''' Err CncProfileSettingSet ( CncProfileID iProfileId, UInt16 paramId, const void *paramBufferP, UInt16 paramSize ) '''パラメータ''' *{{span style='color:blue;font-family:monospace;',→ profileId}} **プロファイルの ID。 *{{span style='color:blue;font-family:monospace;',→ paramId}} **パラメータの ID。プリ-インストールされたプロファイルの中で定義されたパラメータのリストは、{{goto General Profile Parameters,General Profile Parameters}} を参照してください。 *{{span style='color:blue;font-family:monospace;',→ paramBufferP}} **このパラメータにセットする値へのポインタ。 *{{span style='color:blue;font-family:monospace;',→ paramSize}} **{{span style='color:blue;font-family:monospace;',paramBufferP}} の中に渡されるバッファのサイズ。{{goto Profile Parameter Sizes,Profile Parameter Sizes}} を参照してください。 '''返り値''' *{{span style='color:blue;font-family:monospace;',errNone}} **エラーはありません。 *{{span style='color:blue;font-family:monospace;',kCncErrDBAccessFailed}} **プロファイルデータベースをオープンすることができませんでした。 *{{span style='color:blue;font-family:monospace;',kCncErrProfileParamNotFound}} **指定された ID を持つプロファイルはありません。 *{{span style='color:blue;font-family:monospace;',kCncErrProfileSetParamFailed}} **接続マネージャはパラメータの値をセットするのに失敗しました。 *{{span style='color:blue;font-family:monospace;',kCncErrProfileBadParamSize}} **{{span style='color:blue;font-family:monospace;',paramBufferP}} バッファが小さすぎます。たいてい、指定されたサイズが、文字列パラメータの null 終端子をサイズに含めることを許可しないために起こります。 *{{span style='color:blue;font-family:monospace;',kCncErrProfileParamNameHasChange}} **プロファイル名をすでに使用されているプロファイル名にしようとしました。接続マネージャはプロファイル名の最後に重複番号を追加し、このエラーを返します。{{goto CncProfileSettingGet,CncProfileSettingGet()}} を使って新しい名前を探すべきです。 '''互換性''' {{goto Connection Manager Feature Set,Connection Manager Feature Set|Palm OS Programmer's API Referece/B}} が満たされる場合にのみ、実装されます。 '''参照''' {{goto CncDefineParamID,CncDefineParamID()}}, {{goto CncProfileSettingGet,CncProfileSettingGet()}} ---- [[←　60 章に戻る|Palm OS Programmer's API Reference/60]]　[[↑トップへ|Palm OS Programmer's API Reference]]　[[62 章に進む　→|Palm OS Programmer's API Reference/62]]