3.3.4.1 Renew

Renew extends the TTL of a Server Object.

 TimeSpan Renew(
      TimeSpan renewalTime
 );
  

renewalTime: A TimeSpan value that specifies the required TTL for the Server Object.

Return Value: A TimeSpan value that specifies the new TTL for the Server Object.

Exceptions: In addition to the Exceptions common to all Remote Methods in .NET Remoting (as specified in [MS-NRTP] section 3.2.5.1.7.2), if the CurrentState value of the associated Lease Data is "Expired", a RemotingException (as specified in [MS-NRTP] section 3.2.5.1.7.2) MUST be sent back.

If the CurrentState value of the associated Lease Data is "Expired", then the implementation MUST NOT modify the TTL; instead, the implementation MUST construct a RemotingException ([MS-NRTP] section 2.2.2.9) as specified in [MS-NRTP] section 3.2.5.1.7.2, Constructing a Remoting Exception. The Exception MUST be sent back to the client.

Otherwise, if the CurrentState is valid, the new TTL for the Server Object is the renewalTime or the current value of the Lease TTL Timer, whichever is greater. The implementation MUST reset the Lease TTL Timer to the new TTL value and return it as the return value of the Renew method.