UnbindInterface

[This is preliminary documentation and subject to change.]

The UnbindInterface function tells the routing protocol that an adapter has been deallocated from the specified interface. The function directs the routing protocol to stop protocol-defined activities over the adapter.

DWORD UnbindInterface(
  ULONG InterfaceIndex  // index of the interface
);
 

Parameters

InterfaceIndex

Identifies the interface in the set of interfaces configured on the router.

Return Values

NO_ERROR

The interface was unbound successfully; the routing protocol has stopped activity over the adapter for this interface.

ERROR_CAN_NOT_COMPLETE

The attempt to unbind the interface failed.

ERROR_INVALID_PARAMETER

The InterfaceIndex parameter is invalid (for example, no interface exists with that index, or the interface exists, but is already unbound).

Remarks

The routing protocol should no longer consider routes dynamically obtained through the interface to be valid. It should remove these routes from the routing table.

QuickInfo

  Windows NT: Use version 5.0 and later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in routprot.h.
  Import Library: user-defined.

See Also

BindInterface, UnbindInterface Sample