Platform SDK: TAPI

IMcastLeaseInfo::get_ServerAddress

The get_ServerAddress method obtains a string representing the address of the multicast server granting this lease.

HRESULT get_ServerAddress(
  BSTR *ppAddress
);

Parameters

ppAddress
[out] Pointer to a BSTR that will receive a string representation of the address of the server granting this request or renewal.

Return Values

Value Meaning
S_OK Method succeeded.
S_FALSE Server address unspecified.
E_POINTER The caller passed in an invalid pointer argument.
E_OUTOFMEMORY Not enough memory exists to allocate the string.

Remarks

The BSTR string ppAddress is an IP version 4 address in dotted quad notation (for example, 10.111.222.111). If a lease information object does not describe a granted lease (for example, it was not returned by IMcastAddressAllocation::RequestAddress or IMcastAddressAllocation::RenewAddress), the address is reported as the string "Unspecified".

The application must use SysFreeString to free the memory allocated for the ppAddress parameter.

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

IMcastLeaseInfo