Platform SDK: TAPI

IMcastAddressAllocation::RenewAddress

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

HRESULT RenewAddress(
  long lReserved,
  IMcastLeaseInfo *pRenewRequest,
  IMcastLeaseInfo **ppRenewResponse
);

Parameters

lReserved
[in] Reserved parameter. An application should pass in a value of 0..
pRenewRequest
[in] 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.
ppRenewResponse
[out] 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 Values

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

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Mdhcp.h.
  Library: Use Mdhcpid.lib.

See Also

IMcastAddressAllocation