AAO DRAMA C++ Interface (Old style)
DRAMA C++, Depreciated, don't use for new code

◆ MGet() [1/2]

virtual DcppHandlerRet DcppTask::MGet ( const DcppHandlerRoutine  SuccessHandler,
const DcppHandlerRoutine  ErrorHandler,
const DcppHandlerRoutine  ErsHandler,
const DcppVoidPnt  ClientData,
unsigned  count,
StatusType *  status,
  ... 
)
virtualinherited

Send a DRAMA message to the task to get the value of multiple parameters.

This is the a method for sending an MGET message to the task referred to by this object - to return the value of a multiple parameters. We must already have path to the task. This version supports explict handling of any Ers messages.

If this function returns DcppReschedule, then messages are expected and should be dispatched using DcppDispatch() when they arrive. This will ensure that future processing occurs correctly and the the appropriate handler is invoked when the operation completes.

Returns
DcppReschedule if a message was started. Otherwise DcppFinished and status will be set bad.
Parameters
SuccessHandlerDcppDispatch() will invoke this if the operation completes successfully.
This function should return DcppReschedule if it sends another message.
Otherwise it should return DcppFinished.
The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished.
ErrorHandlerDcppDispatch() will invoke this if the operation fails after a message has been sent. This function should return DcppReschedule if it sends another message.
Otherwise it should return DcppFinished.
The value returned will be returned by DcppDispatch(). If not specified, DcppDispatch() just returns DcppFinished.
ClientDataPassed directly to the handler functions.
countThe number of parameters.
ErsHandlerDcppDispatch() will invoke this if a Ers message is received. If not specified, DcppDispatch just returns DcppReschedule, which is what your handler would normally return, since more messages are expected. This would normally only happen if the message was sent in UFACE context DitsInterested() was used to indicate an interest in ERS messages.
statusInherited Status
...The parameter names, all "const char *".