4.7.2 dc_clt_cancel_notification_s一方通知待ち状態のキャンセル

<この項の構成>
(1) 形式
(2) 機能
(3) UAPで値を設定する引数
(4) リターン値
(5) 注意事項

(1) 形式

(a) TP1/Client/Wの場合
●_s付き関数

#include <dcvclt.h>
DCLONG dc_clt_cancel_notification_s(
                          HWND hWnd, char *defpath,
                          char *inf, DCLONG inf_len,
                          unsigned short port,
                          char *hostname, DCLONG flags)

●_s無し関数

#include <dcvclt.h>
DCLONG dc_clt_cancel_notification(
                         char *inf, DCLONG inf_len,
                         unsigned short port, char *hostname,
                         DCLONG flags)

(b) TP1/Client/Pの場合
●_s付き関数

#include <dcvclt.h>
DCLONG dc_clt_cancel_notification_s(
                        HWND hWnd, char CLTFAR *defpath,
                        char CLTFAR *inf, DCLONG inf_len,
                        unsigned short port,
                        char CLTFAR *hostname, DCLONG flags)

●_s無し関数

#include <dcvclt.h>
DCLONG dc_clt_cancel_notification(
                         char CLTFAR *inf, DCLONG inf_len,
                         unsigned short port, char CLTFAR *hostname,
                         DCLONG flags)

(2) 機能

サーバからの一方通知受信待ち状態(dc_clt_accept_notification_s関数発行)を解除します。解除するときに,引数infに指定したメッセージを一方通知受信待ち状態のCUPに通知できます。

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

(4) リターン値

リターン値数値
(10進数)
意味
DC_OK0正常終了しました。
DCCLTER_INVALID_ARGS-2501引数に指定した値が誤っています。
DCCLTER_FATAL-2503初期化に失敗しました。または,クライアント環境定義の指定に誤りがあります。
DCCLTER_NO_BUFS-2504必要なバッファが確保できませんでした。または,リソース不足が発生しました。
DCCLTER_NET_DOWN-2506ネットワーク障害が発生しました。
DCCLTER_SERVICE_NOT_UP-2514CUPが一方通知受信待ち状態ではありません。
DCCLTER_SYSERR-2518システムエラーが発生しました。
DCCLTER_WRONG_HOST-2539ホスト名が不正です。
DCCLTER_PORT_IN_USE-2547OSが自動的に割り当てるポート番号が不足しています。

(5) 注意事項

TP1/Clientでは,dc_clt_cancel_notification_s関数の呼び出しごとにクライアント環境定義を定義できます。dc_clt_cancel_notification_s関数の呼び出しごとにクライアント環境定義を定義するには,dc_clt_cancel_notification_s関数の呼び出しごとに,異なるファイルをクライアント環境定義ファイルとして作成して,そのファイル名をdc_clt_cancel_notification_s関数の引数defpathに指定してください。