Skip to main content

This documentation is for an older version of this product. See the latest version of this content.Opens in a new tab

$ZF(-6) (ObjectScript)

$ZF(-4) を使用してインデックス作成された DLL 関数を実行します。この関数は、コールアウト SDK のコンポーネントです。

Synopsis

$ZF(-6,dll_index,func_id,args)

引数

引数 説明
dll_index $ZF(-4) から発生した、DLL インデックス・テーブルの DLL ファイル名に対するユーザ指定のインデックス。
func_id オプション — $ZF(-4) から提供された、DLL 内の関数の ID 値。これを省略した場合は、呼び出しによって DLL_index の妥当性を検証し、イメージをロードして、イメージの位置を返します。
args オプション — 関数に渡す引数で、存在する場合はコンマで区切られたリストの形式で指定します。

概要

$ZF(-6) は、DLL ファイル名に対するユーザ定義のインデックスを使用して、ダイナミック・リンク・ライブラリ (DLL) 関数の高速インタフェースを提供します。整数 (dll_index) を割り当て、dll_name と一意に関連付けることによって、$ZF(-4) でこのユーザ定義のインデックスを確立します。このエントリは、プロセス DLL インデックス・テーブルか、システム DLL インデックス・テーブルに配置できます。

$ZF(-5)$ZF(-6) はいずれも、$ZF(-4) によって位置を確認された DLL からの関数の実行に使用できます。

$ZF(-6) の使用法の詳細は、"コールアウト SDK の使用法" の “ユーザ・インデックスによるライブラリへのアクセスでの $ZF(-6) の使用” を参照してください。

別の DLL に依存する DLL のロード

Windows では、bin ディレクトリにインストールされる一部のシステム DLL は、bin ディレクトリ内の別の DLL に依存しています。Windows の検索規則では、bin をそのプロセスの PATH に追加しない限り、bin ディレクトリ内の依存関係は検索されません。ただし、これらの DLL の 1 つが $ZF(-4) または $ZF(-6) を使用して呼び出された場合、InterSystems IRIS は、最初に DLL のロード元のディレクトリで依存 DLL を検索します。その場所で依存 DLL が見つからなかった場合は、既定の検索 PATH が使用されます。InterSystems IRIS はこのために、Windows のロード操作を使用して、DLL のロード時に開始ディレクトリを一時的に PATH に追加します。この一時的な PATH の追加は、DLL が $ZF(-4) または $ZF(-6) によってロードされている場合に使用されます。この一時的な PATH の追加は、DLL が $ZF(-3) によってロードされている場合には使用されません。

DLL の依存関係を解決できない場合、InterSystems IRIS は <DYNAMIC LIBRARY LOAD> エラーを発行します。

関連項目

FeedbackOpens in a new tab