nn::nex::DataSet::UpdateIsRequired Member Function

Syntax

qBool UpdateIsRequired(
     const DuplicatedObject * pDO,
     const Station * pStation
);

Parameters

Name Description
in pDO A pointer to the duplicated object associated with this dataset is passed.
in pStation A pointer to the station whose dataset is about to be updated is passed.

Return Values



Value Description
true Returned when updating this dataset on pStation (true is always returned by default).
false Returned when not updating this dataset on pStation.

Description

Selects the station whose dataset is to be updated.

If station_filter is attached to the update policy of the data set in the data definition language (DDL) declaration, the system calls this function each time an attempt is made to update the dataset, allowing you to select which stations to perform the update on. Filtering the stations to be updated using station_filter is significant in two ways.

First, optimization by saving network bandwidth is possible by filtering the stations to be updated. For example, not knowing the exact location and behavior of distant objects is sometimes not a problem. Bandwidth can be conserved in such cases by skipping the transfer of update data.

Second, filtering stations aids in security. For example, you can decide whether updates should be carried out for all stations depending on whether the dataset represents disclosed information, only partially disclosed information, or undisclosed information. (There may even be other situations depending on the application.) For example, information such as the cards a player holds in a card game or the position of a stealth weapon in a war game is not disclosed to all players, and in a role-playing game, only you and the members of the guild you belong to can know the items you carry. (Of course, this is not always the case and may differ depending on the specifications of the game in question.)

Revision History

2011/01/27
Initial version.

CONFIDENTIAL