OpenTP1 Version 7 TP1/Client User's Guide TP1/Client/W, TP1/Client/P

[Contents][Index][Back][Next]

4.7.3 dc_clt_open_notification_s - Start reception of one-way messages

Organization of this subsection
(1) Form
(2) Purpose
(3) Arguments set by UAPs
(4) Arguments specifying the containers of returned values
(5) Return values
(6) Notes

(1) Form

(a) TP1/Client/W
_s version of the function
 
#include <dcvclt.h>
DCLONG dc_clt_open_notification_s(HWND hWnd,
                                  DCCLT_ID *ntfid,
                                  char *defpath,
                                  unsigned short port,
                                  DCLONG flags)
 
Non-_s version of the function
 
#include <dcvclt.h>
DCLONG dc_clt_open_notification(unsigned short port,
                                DCLONG flags)
 
(b) TP1/Client/P
_s version of the function
 
#include <dcvclt.h>
DCLONG dc_clt_open_notification_s(HWND hWnd,
                                  DCCLT_ID CLTFAR *ntfid,
                                  char CLTFAR *defpath,
                                  unsigned short port,
                                  DCLONG flags)
 
Non-_s version of the function
 
#include <dcvclt.h>
DCLONG dc_clt_open_notification(unsigned short port,
                                DCLONG flags)
 

(2) Purpose

The dc_clt_open_notification_s function creates an environment for using the facility for receiving one-way messages from the server.

The dc_clt_open_notification_s and dc_clt_close_notification_s functions are used in a pair.

(3) Arguments set by UAPs

(4) Arguments specifying the containers of returned values

(5) Return values

Return value Value (decimal) Meaning
DC_OK 0 The function normally terminated.
DCCLTER_INVALID_ARGS -2501 The value specified in an argument is incorrect.
DCCLTER_PROTO -2502 The dc_clt_open_notification function has already been executed. This value is not returned if the dc_clt_open_notification_s function is executed.
DCCLTER_FATAL -2503 Initialization failed. Alternatively, the client environment definition is specified incorrectly.
DCCLTER_NO_BUFS -2504 A necessary amount of buffer could not be allocated.
DCCLTER_PORT_IN_USE -2547 The specified port number has already been used.

(6) Notes