OpenTP1 Version 7 Programming Reference C Language
dc_rpc_get_gateway_address - Acquire the node address of a gateway
Format
ANSI C, C++
#include <dcrpc.h> int dc_rpc_get_gateway_address(DCULONG *node,DCLONG flags) |
K&R C
#include <dcrpc.h> int dc_rpc_get_gateway_address(node, flags) DCULONG *node; DCLONG flags; |
Description
The function dc_rpc_get_gateway_address acquires the node address of a gateway from the server UAP when a service request was received from a client UAP via a gateway, such as the application gateway FireWall.
The server UAP can acquire the node address of the gateway when a service was requested using the remote API facility.
A service response or error response cannot be sent using the address that is returned for the function dc_rpc_get_gateway_address.
Call the function dc_rpc_get_gateway_address from the service function. Processing is not guaranteed if the function is called from a function other than the service function.
Arguments whose values are set in the UAP
node
Specify the address of the area to which the node address of the gateway is to be returned.
flags
Specify DCNOFLAGS.
Arguments whose values are returned from OpenTP1
node
The node address of the gateway is returned. The value 0 is set when the remote API facility was not used.
Return values
Return value | Return value (numeric) | Explanation |
---|---|---|
DC_OK | 0 | Normal termination |
DCRPCER_INVLAID_ARGS | -301 | The value specified for the argument is invalid. |
DCRPCER_PROTO | -302 | The function dc_rpc_get_gateway_address was not called from the service function. |
All Rights Reserved. Copyright (C) 2006, 2010, Hitachi, Ltd.