ldtパン・サブルーチン
目的
共通オブジェクト・ファイルの索引付きシンボル・テーブル・エントリーを読み取ります。
ライブラリー
オブジェクト・ファイル・アクセス・ルーチン・ライブラリー (libld.a)
構文
#include <stdio.h>
#include <ldfcn.h>
int ldtbread ( ldPointer, SymbolIndex, Symbol)
LDFILE *ldPointer;
long SymbolIndex;
void *Symbol;
#include <ldfcn.h>
int ldtbread ( ldPointer, SymbolIndex, Symbol)
LDFILE *ldPointer;
long SymbolIndex;
void *Symbol;
説明
ldtパン サブルーチンは、 ldPointer パラメーターに現在関連付けられている共通オブジェクト・ファイルの SymbolIndex パラメーターで指定されたシンボル・テーブル・エントリーを、 Symbol パラメーターで始まるメモリー領域に読み込みます。 関連オブジェクト・ファイルのシンボル・テーブル項目を入れるのに十分な大きさのバッファーへのポインターを提供するのは、呼び出しルーチンの責任です。 ldopen サブルーチンは ( HEADER (ldPointer) .f_magic マクロを介して) マジック・ナンバー情報を提供するため、呼び出し側アプリケーションは常に、 シンボル ・ポインターが 32 ビットの SYMENT または 64 ビットの SYMENT_64 構造体を参照すべきかどうかを判別できます。
パラメーター
| 項目 | 説明 |
|---|---|
| ldPointer | LDOPEN または LDA オープン サブルーチンへの正常な呼び出しの結果として戻された LDFILE (ファイル) 構造体を指します。 |
| SymbolIndex | 読み取られるシンボル・テーブル・エントリーの索引を指定します。 |
| シンボル | 32 ビットまたは 64 ビットのいずれかの SYMENT (システム) 構造体を指します。 |
戻り値
LDT ブレッド サブルーチンは、SUCCESS または FAILURE 値を返します。
エラー・コード
SymbolIndex パラメーターがオブジェクト・ファイル内のシンボルの数以上の場合、または指定されたシンボル・テーブル・エントリーを読み取ることができない場合、 ldtパン サブルーチンは失敗します。
注: シンボル・テーブルの最初のシンボルのインデックスは 0 です。