The MprAdminInterfaceTransportRemove function removes a transport (for example, IP or IPX) from a specified interface.
DWORD MprAdminInterfaceTransportRemove( MPR_SERVER_HANDLE hMprServer, // handle to router HANDLE hInterface, // handle to interface DWORD dwTransportId // transport/router manager ID );
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 | Meaning |
---|---|
ERROR_ACCESS_DENIED | The calling application does not have sufficient privileges. |
ERROR_INTERFACE_CONNECTED | The interface specified is a demand-dial interface and is currently connected. |
ERROR_INVALID_HANDLE | The hInterface value is invalid. |
ERROR_NO_SUCH_INTERFACE | The specified transport is not running on the specified interface. |
ERROR_UNKNOWN_PROTOCOL_ID | The dwTransportId value does not match any installed transport. |
The dwTransportId parameter specifies a router manager because a Windows 2000 router uses a different router manager for each routable transport.
Windows NT/2000: Requires Windows 2000.
Header: Declared in Mprapi.h.
Library: Use Mprapi.lib.
Router Management Reference, Router Administration Functions, MprAdminInterfaceCreate, MprAdminInterfaceTransportAdd, MprAdminServerConnect