McastRenewAddress function (madcapcl.h)

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

Syntax

DWORD McastRenewAddress(
  [in]      IP_ADDR_FAMILY        AddrFamily,
  [in]      LPMCAST_CLIENT_UID    pRequestID,
  [in]      PMCAST_LEASE_REQUEST  pRenewRequest,
  [in, out] PMCAST_LEASE_RESPONSE pRenewResponse
);

Parameters

[in] AddrFamily

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

[in] pRequestID

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

[in] pRenewRequest

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

[in, out] pRenewResponse

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 value

The McastRenewAddress function returns the status of the operation.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header madcapcl.h
Library Dhcpcsvc.lib
DLL Dhcpcsvc.dll

See also

IPNG_ADDRESS

MCAST_CLIENT_UID

MCAST_LEASE_REQUEST

MCAST_LEASE_RESPONSE

MCAST_SCOPE_CTX

MCAST_SCOPE_ENTRY

McastApiCleanup

McastApiStartup

McastEnumerateScopes

McastGenUID

McastReleaseAddress

McastRequestAddress