BindInterface

[This is preliminary documentation and subject to change.]

The BindInterface function tells the routing protocol that an adapter has been allocated for an interface. The function directs the routing protocol to start protocol-defined activities over this adapter for the interface (unless the interface is administratively disabled).

DWORD BindInterface(
  ULONG InterfaceIndex,  // index of the interface
  PVOID BindingInfo      // adapter information block
);
 

Parameters

InterfaceIndex

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

BindingInfo

Pointer to a buffer that contains transport-specific information. This information allows the routing protocol to communicate with other routing agents over the interface.

Return Values

NO_ERROR

The interface is now bound to the specified adapter.

ERROR_CAN_NOT_COMPLETE

The attempt to bind the interface to the adapter failed.

ERROR_INVALID_PARAMETER

At least one of the following is true:

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

One of the parameters in the adapter information pointed to by the BindingInfo parameter is invalid.

Remarks

If this function is called on an interface that is administratively enabled, the routing protocol should activate the interface.

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 Sample, IP_ADAPTER_BINDING_INFO, IPX_ADAPTER_BINDING_INFO, UnbindInterface