MprConfigInterfaceTransportRemove

The MprConfigInterfaceTransportRemove function removes the specified transport from the specified interface configuration on the router.

DWORD MprConfigInterfaceTransportRemove(
  HANDLE hMprConfig,         // handle to the router configuration
  HANDLE hRouterInterface,   // handle to the interface configuration
  HANDLE hRouterIfTransport  // handle to the transport configuration
);

Parameters

hMprConfig
[in] Handle to the router configuration. The handle is obtained from a previous call to MprConfigServerConnect.
hRouterInterface
[in] Handle to the interface configuration from which to delete the specified transport. Obtain this handle by calling MprConfigInterfaceCreate, MprConfigInterfaceGetHandle, or MprConfigInterfaceEnum.
hRouterIfTransport
[in] Handle to the interface transport configuration to be deleted. Obtain this handle by calling MprConfigInterfaceTransportAdd, MprConfigInterfaceTransportGetHandle, or MprConfigInterfaceTransportEnum.

Return Values

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_INVALID_PARAMETER One of the following is true:
  • hMprConfig is NULL.
  • hRouterInterface is NULL.
  • phRouterIfTransport is NULL.
Other Use FormatMessage to retrieve the system error message that corresponds to the error code returned.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Header: Declared in Mprapi.h.
  Library: Use Mprapi.lib.

See Also

Router Management Reference, Router Configuration Functions, FormatMessage, MprConfigInterfaceCreate, MprConfigInterfaceEnum, MprConfigInterfaceGetHandle, MprConfigInterfaceTransportAdd, MprConfigInterfaceTransportEnum, MprConfigInterfaceTransportGetHandle, MprConfigServerConnect