SE_registration_get_difference_list

Retrieves an array of SE_REGINFO objects from a specified section of the state tree.

Usage syntax

LONG SE_registration_get_difference_list
(SE_CONNECTION connection,
LONG state1_id,
LONG state2_id,
SE_REGINFO **reg_list_addr,
LONG *count_addr);

Parameters
connection The current connection
state1_id The ID of the first state
state2_id The ID of the second state
reg_list_addr Address of a pointer in dynamically allocated space that will contain an array of SE_REGINFO objects
count_addr The number of SE_REGINFO objects
Description

SE_registration_get_difference_list returns a dynamically allocated list of registration entries for all of the multiversion tables that are modified in either of the input states or any of the states joining them in the state tree (excluding their shared parent), and for which the current user has any access to the DBMS tables. This can be used to help implement manual difference resolution. The two states may also be the same, in which case only those tables modified in that particular state are returned.

Returns

SE_SUCCESS
SE_DB_IO_ERROR

SE_INVALID_POINTER

SE_INVALID_STATE_ID

SE_NET_FAILURE

SE_OUT_OF_CLMEM

SE_OUT_OF_SVMEM

SE_STATE_NOEXIST

Notes

•  The application must free the memory used by this call. See SE_registration_free_info_list .