nn::nex::DOCallContext::Flags Enumerated Type

Syntax

enum Flags;

Value

Value Description
SynchronousCall The call is a synchronous call. (The function does not return until it has finished all tasks.)
TargetObjectMustBeMaster This call is only performed by the duplication master of the object. This flag is only included to support RMCContext. It is enabled only when the CallOnMaster flag has also been set. It may also be used together with the RetryOnTargetValidationFailure flag.
TargetObjectMustHaveAuthority When making this call, the target object must have authority (see DuplicatedObject::HasAuthority). This flag is only included to support RMCContext. It is enabled only when the CallOnMaster flag has also been set. It may also be used together with the RetryOnTargetValidationFailure flag.
RetryOnTargetValidationFailure If the result of this call (Outcome) is ErrorInvalidRole or ErrorNoAuthority, the same message is sent again to the duplication master until Success is returned or an error other than ErrorInvalidRole or ErrorNoAuthority is returned. This flag is only included to support RMCContext. This flag is enabled only when one of the CallOnMaster, TargetObjectMustHaveAuthority, or TargetObjectMustBeMaster flags has been set.
CallOnDuplicas This call is called for all duplicas. This flag is only included to support RMCContext. It is enabled only when the OneWayCall flag has also been set. This call can only be made from the duplication master.
CallOnMaster This call is made to the duplication master. This flag is only included to support RMCContext. The FlagsAreValid test can only be correctly passed when it can been confirmed that the target object of the call is a duplication master. To pass this test, there must be a reference to the correct target duplicated object.
CallOnTargetStation Do not use this flag directly. It is set automatically when the SetTargetStation function is called.
CallOnNeighbouringStations This method is called for all neighboring stations. In other words, it is called for all stations in the session known by the local station. Determining which stations to select as neighboring stations depends either on the duplication space being used by the local station or on some other discovery mechanism. This flag can only be set for RMCContext, and it is only valid when the OneWayCall flag is set at the same time. For the current implementation, we recommend using CallOnDuplicas because it is equivalent.
CallOnLocalStation This method is called for the local station. It only exists to support RMCContext.

Description

Enumerated type that defines flags that can be used in the CallContext.

Revision History

2011/01/27
Initial version.

CONFIDENTIAL