How to issue requests

This document describes how an active object issues a request for a service.

Once the active object has been constructed, a request can be issued. In the following code fragment, the active object provides the function IssueRequest() to invoke the encapsulated service function.

      
       
      
      void CExampleActiveObject::IssueRequest()
    {
        // Request the service
    iServiceProvider-> RequestTheService(iStatus);
        // Indicate request has been issued
    SetActive();
    }
     

• Pass the TRequestStatus object, provided by the active objects's CActive base class, to the service function. As part of its processing, the service function sets this to KRequestPending , indicating that the request has been issued but is not yet complete.

• Set the base class's active request flag, using the function SetActive() , to indicate that the active object is currently active. The flag is reset by the active scheduler before handling a completed request, or by the active object base class as part of the cancellation protocol.