Platform SDK: TAPI

IMcastScope::get_InterfaceID

The get_InterfaceID method obtains an interface identifier of this scope, which identifies the interface on which the server that published this scope resides. This is normally the network address of the interface.

HRESULT get_InterfaceID(
  long *pID
);

Parameters

pID
[out] Pointer to a LONG that will receive the server ID of this scope, which is the ID that was assigned to the multicast address allocation server that published this scope at the time that the server was configured.

Return Values

Value Meaning
S_OK Method succeeded.
E_POINTER The caller passed in an invalid pointer argument.

Remarks

The InterfaceID is provided for informational purposes only; it is not required as input to any of the methods in these interfaces. However, it may factor into the application's (or the user's) decision as to which scope to use when requesting an address. This is because, in a multi-homed scenario, using a multicast address on one network that was obtained from a server on another network may cause address conflicts.

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

IMcastScope