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

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

2.12.1 Host name length and host name storage area length that can be specified in the arguments of C functions

The host name extension function extends the host name length and the host name storage area length that can be specified in the arguments of C functions.

The following table shows the host name lengths that can be specified in the arguments of C functions.

Table 2-9 Host name lengths that can be specified in the arguments of C functions

Function
Argument
Multiple hosts specifiable
Specifiable host name length
Not extended Extended
dc_clt_cltin_s target_host Yes
63 characters (255 characters)#
255 characters (1023 characters)#
dc_clt_set_raphost_s raphost
DCRPC_DIRECT_SCHEDULE hostnm No

63 characters

255 characters

dc_clt_cancel_notification_s hostname
dc_clt_send_s hostname

Legend:
Yes: Multiple hosts can be specified.
No: Multiple hosts cannot be specified.

#
A number in parentheses indicates the maximum number of characters that can be specified in an argument (includes a port number and separators).

The following table shows the host name storage area length that can be specified in the arguments of C functions.

Table 2-10 Host name storage area lengths that can be specified in the arguments of C functions

Function
Argument
Number of hosts to be stored
Host name storage area length
Not extended (bytes) Extended (bytes)
dc_clt_get_raphost_s raphost Multiple 256 or more 1024 or more
dc_clt_cltin_s set_host 1

64 or more

256 or more

dc_clt_accept_notification_s hostname
dc_clt_chained_accept_notification_s hostname

Note
For the above arguments, you must prepare an area equal to or greater than the specification shown above. If the length of the area you prepare is smaller than the specification, the CUP may terminate abnormally.