dc_adm_get_node_id - Acquire the node identifier of the local node

Format

ANSI C, C++

#include <dcadm.h>
int dc_adm_get_node_id (char *node_id, DCLONG flags)

K&R C

#include <dcadm.h>
int dc_adm_get_node_id (node_id, flags)
char       *node_id;
DCLONG      flags;

Description

The function dc_adm_get_node_id() returns the node identifier of the local OpenTP1 node specified in the system common definition to the area identified by node_id.

Arguments whose value is set in the UAP

node_id

Specify the pointer to the area which will receive the node identifier. A null character is added at the end of the node identifier. The length of the area must be equal to the length defined by DCADM_NODE_ID_SIZE.

flags

Specify DCNOFLAGS.

Return values

Return valueReturn value (numeric)Explanation
DC_OK0Normal termination.
DCADMER_PARAM-1852The value specified for the argument is invalid.
DCADMER_PROTO-1854The function dc_rpc_open() was not called.