4.7.5　dc_clt_chained_accept_notification_s − 一方通知受信

(1)　形式

#include <dcvclt.h>
DCLONG dc_clt_chained_accept_notification_s
                             (DCCLT_ID ntfid, char *inf,
                              DCLONG *inf_len,
                              DCLONG timeout,
                              char *hostname,
                              char *nodeid,
                              DCLONG flags)

#include <dcvclt.h>
DCLONG dc_clt_chained_accept_notification
                       (char *inf, DCLONG *inf_len,
                        DCLONG timeout, char *hostname,
                        char *nodeid, DCLONG flags)

#include <dcvclt.h>
DCLONG dc_clt_chained_accept_notification_s
                             (DCCLT_ID ntfid, char CLTFAR *inf,
                              DCLONG CLTFAR *inf_len,
                              DCLONG timeout,
                              char CLTFAR *hostname,
                              char CLTFAR *nodeid,
                              DCLONG flags)

#include <dcvclt.h>
DCLONG dc_clt_chained_accept_notification
                       (char CLTFAR *inf, DCLONG CLTFAR *inf_len,
                        DCLONG timeout, char CLTFAR *hostname,
                        char CLTFAR *nodeid, DCLONG flags)

ページの先頭へ

(2)　機能

サーバ側の関数dc_rpc_cltsendによって通知されるメッセージを，引数timeoutで指定した値まで待ち続けます。受信した時点でCUPに制御を戻し，リターン値，通知メッセージ，通知メッセージ長，通知元サーバのホスト名，通知元サーバのノード識別子を返します。この関数を発行する前にdc_clt_open_notification_s関数を発行しておく必要があります。

ページの先頭へ

(3)　UAPで値を設定する引数

• ntfid

  dc_clt_open_notification_s関数で受け取った一方通知受信IDを指定します。

• inf

  サーバからの通知メッセージを格納する領域を指定します。

• inf_len

  サーバからの通知メッセージを格納する領域の長さ（引数infの長さ）を指定します。0からDCRPC_MAX_MESSAGE_SIZE^※の範囲で指定します。

  注※

  クライアント環境定義DCCLTRPCMAXMSGSIZEに2以上を指定した場合，DCRPC_MAX_MESSAGE_SIZEの値（1メガバイト）ではなく，クライアント環境定義DCCLTRPCMAXMSGSIZEに指定した値になります。

• timeout

  タイムアウト値（秒）を指定します。0から65535の範囲で指定します。

  無限に待ち続ける場合は，0を指定します。

• hostname

  通知したサーバのホスト名を格納する，64バイト^※以上の領域を指定します。NULLが指定された場合は，ホスト名を格納しません。

  注※

  クライアント環境定義DCCLTOPTIONに00000008を指定した場合，64バイトではなく，256バイトになります。

• nodeid

  通知したサーバのノード識別子を格納する，8バイトの領域を指定します。

• flags

  DCNOFLAGSを指定します。

ページの先頭へ

(4)　値が返される引数

• inf

  サーバからの通知メッセージが返されます。

• inf_len

  サーバからの通知メッセージ長が返されます。

• hostname

  通知したサーバのホスト名が返されます。

  ホスト名への変換に失敗した場合，10進ドット記法のIPアドレスが返されます。NULLを指定した場合は，返されません。

• nodeid

  通知したサーバのノード識別子が返されます。ノード識別子のフォーマットは次のとおりです。

  

ページの先頭へ

(5)　リターン値

ページの先頭へ

(6)　注意事項

引数hostnameには64バイト^※以上，引数nodeidには8バイト以上の領域を指定してください。領域がこれより小さい場合，TP1/Client内部の処理で領域破壊を起こすおそれがあります。

注※

クライアント環境定義DCCLTOPTIONに00000008を指定した場合，64バイトではなく，256バイトになります。

ページの先頭へ