UnbindInterface callback function

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.

Syntax

DWORD CALLBACK UnbindInterface(
  _In_ ULONG InterfaceIndex
);

Parameters

  • InterfaceIndex [in]
    Specifies the interface in the set of interfaces configured on the router.

Return value

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value is one of the following error codes.

Value Description
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.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Routprot.h

See also

Routing Protocol Interface Reference

Routing Protocol Interface Functions