Caché Direct の使用法

ログ• LogFolder は 特 定 のフォルダにログ・ファイルを 保 存 する 場 合 に 使 用 します。 既 定 では、アプリケーションのメインの実 行 可 能 ファイルが 保 存 されているフォルダに 保 存 されます。 値 が 指 定 されていない 場 合 、または 空 の 場 合 は、 既定 値 が 使 用 されます。この 章 の 後 半 にある "ログ・ファイルのサイズの 制 限 " も 参 照 してください。スイッチは、hivename/Software/InterSystems/Cache キーの 下 にあります。ここで、hivename は 次 のどちらかです。• HKCU (HKEY_CURRENT_USER ハイブ)• HKLM (HKEY_LOCAL_MACHINE ハイブ)また、 指 定 されたアプリケーションを 実 行 している 特 定 のユーザの 場 合 は、さらに 3 種 類 の 値 を 使 用 できます。これらの値 には、ユーザまたはアプリケーション 名 と 基 本 値 名 を 連 結 した 名 前 が 付 けられます。 例 えば、ユーザ 名 が Joeで、アプリケーション 名 が MyApp.exe の 場 合 、LogMaskJoeMyApp、LogMaskJoe、および LogMaskMyApp という 3 つの値 も 使 用 できます。これらの 値 はこの 順 にチェックされます。それぞれの 値 はまず、HKCU でチェックされ、 次 に HKLMでチェックされます。 最 初 に 見 つかったものが 使 用 されます。 同 様 に、LogFolderJoeMyApp、LogFolderJoe、LogFolderMyApp という 名 前 の 値 が 使 われることもあります。7.1.3 レジストリ 値 の 取 得 と 設 定これらのレジストリ 値 を 設 定 し、 取 得 するために 使 用 できるクライアント 側 ルーチンは 4 種 類 あります。これらのルーチンは、ISLog.dll ファイルに 公 開 されています。これらの C シグニチャは 次 のとおりです。DWORD GetRegLogMaskEx(LPCSTR pUsername, LPCSTR pAppname);DWORD SetRegLogMaskEx(HKEY hiveKey,LPCSTR pUsername,LPCSTR pAppname,DWORD dwMask);int GetRegLogFolderEx(LPCSTR pUsername,LPCSTR pAppname,LPSTR buf,int buflen);void SetRegLogFolderEx(HKEY hiveKey,LPCSTR pUsername,LPCSTR pAppname,LPSTR buf);いずれの 場 合 も、pUsername または pAppname が NULL または 空 の 文 字 列 である 場 合 、これらの 引 数 は 使 用 されません。これらの 引 数 が 指 定 された 場 合 、Get_ routines は 適 切 な 組 み 合 わせを 検 索 し、 最 初 に 見 つかったものがあれば、それを 返 します。例 えば、GetRegLogMaskEx(NULL, “Joe”, NULL) を 呼 び 出 した 場 合 、 最 初 に、HKCU と HKLM から LogMaskJoe が検 索 され、 次 に、HKCU と HKLM から LogMask が 検 索 され、 最 初 に 見 つかったものが 返 されます。 何 も 見 つからなかった 場 合 は 0 が 返 されます。pUsername と pAppname の 両 方 が 指 定 されている 場 合 、4 つの 組 み 合 わせがすべて、 上 記の 順 序 で 検 索 されます。SetRegLogMaskEx および SetRegLogFolderEx ルーチンでは、HKCU または HKLM が 最 初 の 引 数 に 指 定 されている 場合 、そのハイブが 設 定 されます。ハイブが 指 定 されていない 場 合 、 既 定 値 の HKLM が 設 定 されます。SetRegLogMaskEx は 現 在 設 定 しているキーに 直 前 に 設 定 されていた 値 を 返 します。GetRegLogFolderEx は 見 つかったフォルダ 名 の 長 さを 返 します。 見 つからなかった 場 合 は、0 を 返 します。7.1.4 ログ・ファイルのサイズの 制 限2 種 類 のクライアント 側 レジストリ 設 定 (LogSizeLimit) を 使 用 して、ログ・ファイルが 大 きくなりすぎるのを 防 ぐことができます。スイッチは、HK/Software/InterSystems/Cache キーの 下 にあります。 前 述 のとおり、HK は HKCU または HKLMのどちらかです。44 Caché Direct の 使 用 法