OpenTP1 Version 7 Programming Reference C Language

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

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 value Return value (numeric) Explanation
DC_OK 0 Normal termination.
DCADMER_PARAM -1852 The value specified for the argument is invalid.
DCADMER_PROTO -1854 The function dc_rpc_open() was not called.