Caché Direct の使用法

非 ActiveX アプリケーションでの Caché Direct の 使 用 法次 に、CtrlExec() メソッドではなく、CDLink の CtrlExec1() メソッドの 使 用 をお 勧 めします。CtrlExec1 メソッドは、ミラーリングされたプロパティのコンテナとして 使 用 される CDParms クラスで 使 用 するように 設 計 されていています。6.3 メモ参 考 までに、Caché Direct クラスの 構 成 を 理 解 しておくと 便 利 です。まず、 次 の 主 要 なクラスがあります。• CDLink クラスはクライアントを 表 します。VisM コントロールは、このクラスのラッパです。このクラスは、クライアントにより 必 要 とされる 共 通 プロパティやメソッドを 公 開 します。プロパティには、タイムアウト、コールバック 関 数 ポインタ、CDMsg オブジェクト、Error、ErrorName、ErrorTrap、キープアライブ、クライアント・タグなどがあります。メソッドには、 独 自 のプロパティを 管 理 するメソッドや、 必 要 に 応 じて 作 成 される CDConnect オブジェクトのメソッドなどがあります。CDLink はそれぞれ、0 個 または 1 個 の CDConnect にアタッチできます。• CDConnect クラスは、このドキュメントの 前 半 で 説 明 したとおり、CDConnect オブジェクトを 表 します。このクラスには、 基 礎 となる 通 信 DLL ( 古 い NTI DLL、または Kerberos セキュリティを 管 理 する 新 しい CConnect.dll) へのリンクが 含 まれます。また、クライアント 側 の 読 み 取 り/ 書 き 込 みフックも 提 供 します。 実 行 可 能 名 やシグニチャ、ユーザおよびクライアント・マシン 名 など、 基 本 的 な 一 定 のクライアント 情 報 はこのクラスに 保 持 されています。また、 通 信 スレッド、タイムアウト、およびキープ・アライブ 機 能 を 処 理 します。さらに、このクラスは、Connect、Send、SendKeepAlive、Receive、Disconnect などの 基 本 メソッドを 提 供 し、クライアントに 対 して Server プロパティなどのプロパティを 公 開します。また、このサーバが Unicode サーバであるかどうかを 公 開 するほか、サーバのアドレスやポートなどのサーバ・プロパティも 公 開 します。このクラスには、0 個 以 上 のアタッチされた CDLink クライアントのリストも 保 持 されます。• また、 適 切 な 形 式 でメッセージの 構 成 と 分 解 を 行 う 方 法 を 提 供 する CDMsg というヘルパー・クラスもあります。CDMsgは、Init、AppendField、GetField などのメソッドを 提 供 します。CDLink には、クライアントからのメッセージを 構 築 するための CDMsg が 含 まれます。また、CDConnect には、Task や KeepAlive メッセージなど、それ 自 体 を 構 成 するメッセージで 使 用 される CDMsg もあります。直 接 アクセスをサポートするために、 一 部 のヘルパー・クラスも 用 意 されています。• CDProp クラスは 一 部 のデータ 型 を 定 義 し、それらに 変 換 メソッドを 提 供 します。これはミラーリングされたプロパティを 1 つ 表 すために 使 用 されます。• CDParms クラスは、クライアントがサーバに 送 信 するすべての VisM プロパティ (ミラーリングされたプロパティとその他 、 数 個 のプロパティ) に 対 するコンテナです。 内 部 的 に、このクラスには、CDProp の 複 数 のインスタンスが 含 まれます。1 つの CDProp にはプロパティが 1 つ 含 まれます。CDParms は、1 つのクライアントに 対 するすべての CDProps のコレクションです。42 Caché Direct の 使 用 法