20.1.35 [Deprecated] ead_get_node() (acquires information about the original source EADS server from which a specified key was copied)
- Important note
-
This function is deprecated. Instead, use ead_get_original_master_node().
- Organization of this subsection
(1) Description
This function acquires information about the original source EADS server that stores a specified key or group.
By original source EADS server is meant the EADS server that stores the original data of a specified key or group when all EADS servers making up the cluster can be connected successfully.
(2) Format
#include <eads.h> ead_node ead_get_node ( const EAD_CACHE_MANAGER *cmp, /* In */ const char *key, /* In */ int *error_code /* Out */ );
(3) Arguments
- cmp
-
Specifies the handle (pointer) to the cache manager that is managing the cache. Specify a handle obtained from ead_init_client() or ead_init_client_n().
- key
-
Specifies a key that is stored by the target EADS server.
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).
(4) Return value
This function returns information (ead_node structure) about the original source EADS server that stores the specified key or group.
If the function terminates abnormally, it sets 0 in each member of the ead_node structure.
(5) Notes
-
Execution of the application program 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.
-
If there have been no changes to the cluster configuration, information about the same EADS server will always be acquired, regardless of whether that EADS server can be connected.
-
If you plan to use the acquired EADS server as a connection target, use the is_enable member of the ead_node structure to check whether a connection can be established with that EADS server.
For the format and details of the ead_node structure, see 20.1.50 ead_node structure (object used in a user function with an EADS server specified).