IMcastAddressAllocation::RenewAddress method (mdhcp.h)

[Rendezvous IP Telephony Conferencing controls and interfaces are not available for use in Windows Vista, Windows Server 2008, and subsequent versions of the operating system. The RTC Client API provides similar functionality.]

The RenewAddress method renews an address lease. Call CreateLeaseInfo to specify the parameters of the renewal request, and then call this method to make the request.

Syntax

HRESULT RenewAddress(
  [in]  long            lReserved,
  [in]  IMcastLeaseInfo *pRenewRequest,
  [out] IMcastLeaseInfo **ppRenewResponse
);

Parameters

[in] lReserved

Reserved parameter. An application should pass in a value of 0.

[in] pRenewRequest

Pointer to an IMcastLeaseInfo object specifying the attributes of the requested renewal, such as which address(es) to renew. This is obtained by calling CreateLeaseInfo.

[out] ppRenewResponse

Pointer to an interface pointer that will be set to point to a new IMcastLeaseInfo object. This interface can then be used to discover the attributes of the renewed lease. See IMcastScope for more information.

Return value

This method can return one of these values.

Return code Description
S_OK
Method succeeded.
E_POINTER
The caller passed in an invalid pointer argument.
E_INVALIDARG
Requested stop time is prior to the requested stop time.
E_OUTOFMEMORY
Not enough memory to create the required objects.

Requirements

   
Target Platform Windows
Header mdhcp.h
Library Uuid.lib
DLL Mdhcp.dll

See also

IMcastAddressAllocation