SubscribeStateChange

virtual PSubscription ITopController::SubscribeStateChange(TopControllerStateChangeHandler handler) = 0

Registers a callback that is called when the top-controller state changes.

Parameters

handler – Function to be called when the top-controller state changes.

Returns

PSubscription – An ISubscription for the callback.

Throws

• CInvalidArgumentException – Empty callback handler specified.

• CCommunicationErrorException – Protocol error.

• CConnectionLostException – Connection to controller lost.

• CRebootedException – Controller has been rebooted since this object reference was retrieved, invalidating this reference.

• CIncompatibleException – Incompatible firmware version loaded.

• CObjectDestroyedException – Object is destroyed.

Remarks

Execution does not require a subscription resource.