McastRenewAddress

The McastRenewAddress function renews one or more multicast addresses from a MADCAP server.

DWORD APIENTRY McastRenewAddress(
  IP_ADDR_FAMILY AddrFamily,          
  LPMCAST_CLIENT_UID pRequestID,        
  PMCAST_LEASE_REQUEST pRenewRequest,    
  PMCAST_LEASE_RESPONSE pRenewResponse 
);

Parameters

AddrFamily

[in] Designates the address family. Use AF_INET for Internet Protocol version 4 (IPv4), and AF_INET6 for Internet Protocol version 6 (IPv6).

pRequestID

[in] Unique identifier used when the address or addresses were initially obtained.

pRenewRequest

[in] Pointer to the MCAST_LEASE_REQUEST structure containing multicast renew–request parameters.

pRenewResponse

[in, out] Pointer to a buffer containing response parameters for the multicast address–renew request, in the form of an MCAST_LEASE_RESPONSE structure. The caller is responsible for allocating sufficient buffer space for the pAddrBuf member of the MCAST_LEASE_RESPONSE structure to hold the requested number of addresses; the caller is also responsible for setting the pointer to that buffer.

Return Values

The McastRenewAddress function returns the status of the operation.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Madcapcl.h.