McastRequestAddress

The McastRequestAddress function requests one or more multicast addresses from a MADCAP server.

DWORD APIENTRY McastRequestAddress(
  IP_ADDR_FAMILY AddrFamily,            
  LPMCAST_CLIENT_UID pRequestID,       
  PMCAST_SCOPE_CTX pScopeCtx,          
  PMCAST_LEASE_REQUEST pAddrRequest,    
  PMCAST_LEASE_RESPONSE pAddrResponse  
);

Parameters

AddrFamily

[in] Specifies the address family to be used in the request, in the form of an IPNG_ADDRESS structure. Use AF_INET for IPv4 addresses and AF_INET6 for IPv6 addresses.

pRequestID

[in] Pointer to a unique identifier for the request, in the form of an MCAST_CLIENT_UID structure. Clients are responsible for ensuring that each request contains a unique identifier; unique identifiers can be obtained by calling the McastGenUID function.

pScopeCtx

[in] Pointer to the context of the scope from which the address is to be allocated, in the form of an MCAST_SCOPE_CTX structure. The scope context must be retrieved by calling the McastEnumerateScopes function prior to calling the McastRequestAddress function.

pAddrRequest

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

pAddrResponse

[in, out] Pointer to a buffer containing response parameters for the multicast address 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 McastRequestAddress function returns the status of the operation.

Remarks

Before the McastRequestAddress function is called, the scope context must be retrieved by calling the McastEnumerateScopes function.

Requirements

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