_gaiDLVFind()配布状況ファイルの任意のレコードの参照

形式

#include "/NETMRDSEX1/include/dmwapi.h"
int _gaiDLVFind(int *cnt_inf,unsigned int *status,char *key_kind,
char *key,char *deliv_inf);

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

#include "/NETMRDSEX1/include/dmwapi.h"
int _gaiDLVFind(void **cnt_inf,unsigned int *status,char *key_kind,
char *key,char *deliv_inf);

機能

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

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

cnt_inf
配布状況ファイルへのアクセスの開始関数(_gaiDLVStart())の第1引数を設定します。
key_kind
キーの種別を次の形式で指定します(ヘッダファイルで定義済み)。
DMWGAI_DLV_KEY_KIND_ADR
配布先名でサーチします。
DMWGAI_DLV_KEY_KIND_RSC
完全資源名でサーチします。
DMWGAI_DLV_KEY_KIND_STS
配布状況のステータスでサーチします。
key
入力する配布状況の配布名,パッケージ名,または配布状況のステータスを次の形式で指定します。
入力するキーの種別がDMWGAI_DLV_KEY_KIND_ADRの場合
ホスト名〔.ホスト名.ホスト名.…ホスト名〕
入力するキーの種別がDMWGAI_DLV_KEY_KIND_RSCの場合
完全資源名(「DM種別コード.グループ名.資源名.バージョンリビジョン.世代番号」の形式で指定)
入力するキーの種別がDMWGAI_DLV_KEY_KIND_STSの場合
  • DMWGAI_DLV_KEEPING
    指令ファイル受信の完了(KEEPING)
  • DMWGAI_DLV_KEEP
    指令保管の完了(KEEP)
  • DMWGAI_DLV_KEEP_ERROR
    パッケージ保管の失敗(KEEP_ERROR)
  • DMWGAI_DLV_CLT_START
    クライアント起動の完了(CLT_START)
  • DMWGAI_DLV_CLT_START_ERROR
    クライアント起動の失敗(CLT_START_ERROR)
  • DMWGAI_DLV_CLT_WAIT
    クライアント起動待ち(CLT_WAIT)
  • DMWGAI_DLV_INS_WAIT
    組み込み待ち(INS_WAIT)
  • DMWGAI_DLV_GEN_START
    ゼネレータの起動(GEN_START)
  • DMWGAI_DLV_COMPLETE
    実行完了(COMPLETE)
  • DMWGAI_DLV_ERROR
    実行失敗(ERROR)
  • DMWGAI_DLV_SETUP_ERROR
    セットアップエラー(SETUP_ERROR)
deliv_inf
配布状況の受信領域のポインタを設定します。受信領域はサイズに変数名 DMWGAI_DLV_SIZE(ヘッダファイルで定義済み)を指定して確保します。

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

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

リターン値

0:正常終了

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

-1:異常終了

注意事項