OpenTP1 Version 7 Programming Reference C Language

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

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.