(a) TP1/Client/W

_s version of the function

 
#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)
 

Non-_s version of the function

 
#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 version of the function

 
#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)
 

Non-_s version of the function

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

Cancels the wait for receiving a one-way message from the server. The wait state is enabled by the dc_clt_accept_notification_s function.

When canceling the wait state, you can send the message specified for inf to the CUP that waits for a one-way message.

• hWnd
  Specify NULL.
  
• defpath
  Specify the path name of the client environment definition file. The path name must be specified with the full path or a path from the current drive and the current directory. The following shows the order in which files are loaded when the path name is specified.
  
  • In TP1/Client/P
    Client environment definition files are loaded in the following order:
    1. The BETRAN.INI file in the Windows directory
    2. The client environment definition file specified in the defpath argument
    The definitions in both the client environment definition file and the BETRAN.INI file take effect.
    If the same definition is specified in each file with a different value, the value specified in the client environment definition file takes effect.
    If neither the client environment definition file nor the BETRAN.INI file contains the necessary specification, TP1/Client/P uses the defaults.
    
  • In TP1/Client/W
    All definitions specified in the environment variables will be invalid. TP1/Client/W uses the defaults for definitions that are not specified in the client environment definition file specified in the defpath argument.
    
  You can omit the path name by specifying NULL at the beginning of the defpath argument. The following describes the operation when the path name is omitted.
  
  • In TP1/Client/P
    TP1/Client/P uses the BETRAN.INI file in the Windows directory as the client environment definition file. If the BETRAN.INI file does not exist or if the contents of the definition file are invalid, TP1/Client/P uses the defaults.
    
  • In TP1/Client/W
    TP1/Client/W uses the values specified in the environment variables. If an environment variable is not specified, TP1/Client/W uses the default.
    
  The following describes operation when the client environment definition file specified in the defpath argument does not exist or when the contents of the definition file are invalid.
  
  • In TP1/Client/P
    TP1/Client/P uses the BETRAN.INI file in the Windows directory as the client environment definition file. If the BETRAN.INI file does not exist or if the contents of the definition file are invalid, TP1/Client/P uses the defaults.
    
  • In TP1/Client/W
    TP1/Client/W uses the defaults. The values specified in the environment variables will be invalid.
    
• inf
  Specify a message notified to the CUP.
  
• inf_len
  Specify the message length (inf length). Available values range from 0 to DCRPC_MAX_MESSAGE_SIZE^#. Specifying 0 notifies no messages to the CUP.
  

  # If you specify 2 or a larger value for DCCLTRPCMAXMSGSIZE in the client environment definition, the value you specify is used rather than the value of DCRPC_MAX_MESSAGE_SIZE (1 megabyte).

• port
  Specify a port number for the one-way message request between 5001 and 65535.
  
• hostname
  Specify the name of the host on which the CUP is waiting for one-way messages. You can specify a maximum of 63^# characters for the host name.
  You can specify an IP address in decimal dot notation for the host name.
  

  # If you specify 00000008 for DCCLTOPTION in the client environment definition, you can specify a maximum of 255 characters for the host name.

• flags
  Specify DCNOFLAGS.
  

Return Value	Value (decimal)	Meaning
DC_OK	0	Normal termination
DCCLTER_INVALID_ARGS	-2501	Invalid argument
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. Alternatively, resources became insufficient.
DCCLTER_NET_DOWN	-2506	Network error
DCCLTER_SERVICE_NOT_UP	-2514	The CUP is not in the one-way message reception wait status.
DCCLTER_SYSERR	-2518	System error
DCCLTER_WRONG_HOST	-2539	Invalid host computer name
DCCLTER_PORT_IN_USE	-2547	The specified port number is in use, or port numbers that can be assigned automatically by the operating system are insufficient.

In TP1/Client, you can use a different client environment definition for each dc_clt_cancel_notification_s function call. To do so, create a separate client environment definition file for each dc_clt_cancel_notification_s function call, and specify the file name in the defpath argument of the function.