20.1.37 ead_get_current_master_node() (acquires information about the current source EADS server)

(1) Description

This function acquires information about the source EADS server that currently stores a specified key (or group).

To Page Top

(2) Format

#include <eads.h>
ead_node ead_get_current_master_node
(
  const EAD_CACHE_MANAGER     *cmp,          /* In */
  const char                  *key,          /* In */
  int                         *error_code    /* Out */
);

To Page Top

(3) Arguments

cmp

Specifies a handle (pointer) to the cache manager that manages the cache.

Specify a handle obtained from ead_init_client() or ead_init_client_n().

key

Specifies a key (or a group).

For details about the data types that can be specified, see 15.2.2(1) Data types that can be specified as keys.

error_code

Specifies the pointer from which to retrieve the error code.

For details about error codes, see 20.2 Error codes in the client library (C).

To Page Top

(4) Return value

This function returns information about the source EADS server that currently stores the specified key (or group).

If the function terminates abnormally or the source EADS server is isolated or stopped, it sets 0 in each member of the ead_node structure.

To Page Top

(5) Notes

Execution of this function does not establish communication with the EADS server. Therefore, the returned information about the connection-target EADS server might not be the most recent information.

To Page Top