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

◆ Poll()

virtual DcppHandlerRet GitTask::Poll ( StatusType *  status,
GitTaskResponseHandler responseHandler = 0,
bool  freeResponse = false 
)
virtual

Send POLL to the GIT task

The POLL action is sent to the task.

This function returns DcppReschedule if it sent a message. In that case, replies are expected and should be dispatched using DcppDispatch() when they arrive. This will ensure that future processing occurs correctly and the the appropaite handler is invoked when the operation completes.

Note
This operation may return DcppFinished with status ok. This will occur if as a result of sub-classing no messages are sent.
If status is set bad on the call (as against during processing of responses, then the response handler is not invoked.
Parameters
statusInherited status
responseHandlerIf non-null, then this is the address of an object which is notified of the completion of the poll action. The GitTaskResponseHandler::CompleteOk method will be invoked on successfull completion of polling whilst GitTaskResponseHandler::CompleteWithError will be invoked if polling fails. GitTaskResponseHandler::Triggered will be invoked each time a trigger message is received.
freeResponseIf set true, then the response handler is deleted just after the ok or error completion handler is invoked.