JP1/NETM/DM APIリファレンス(UNIX(R)用)

_gaiDLVFindUnique() ― 配布状況ファイルの特定レコードの参照

形式

 
#include "/NETMRDSEX1/include/dmwapi.h"
int _gaiDLVFindUnique（int *cnt_inf，unsigned int *status，char *key，char *deliv_inf）;

OSがHP-UX（IPF）の場合の形式を次に示します。

#include "/NETMRDSEX1/include/dmwapi.h"
int _gaiDLVFindUnique（void **cnt_inf，unsigned int *status，char *key，char *deliv_inf）;

機能

配布状況ファイルから，指定した特定のキーに該当するレコードを読み込みます。

プログラムで値を設定する引数

cnt_inf

配布状況ファイルへのアクセスの開始関数（_gaiDLVStart()）の第1引数を設定します。
key

入力する配布状況のキーを次の形式で指定します。
ホスト名［.ホスト名.…ホスト名］.完全資源名.配布先指令番号
deliv_inf

配布状況の受信領域のポインタを設定します。受信領域はサイズに変数名 DMWGAI_DLV_SIZE（ヘッダファイルで定義済み）を指定して確保します。

JP1/NETM/DM Clientから値が返される引数

status

処理結果の詳細情報を格納するエリアを設定します。

リターン値

0：正常終了

1：配布状況サーバが起動していない

-1：異常終了

注意事項

配布状況ファイル内のレコードは，配布先-資源名-配布先指令番号の組み合わせで，昇順に並んでいます。

配布状況の受信領域に格納される配布状況の任意エリアの参照方法は，配布状況エリアを参照する関数（_gaiDLVReferArea()）を使います。

処理結果の詳細情報格納エリアを参照するときは，処理結果を参照する関数（_gaiDLVGetMainCode()，_gaiDLVGetSubCode()）を使います。

[目次][前へ][次へ]

[他社商品名称に関する表示]