The MprConfigInterfaceTransportAdd function adds the specified transport to the specified interface configuration on the router.
DWORD MprConfigInterfaceTransportAdd(
HANDLE hMprConfig, // handle to the router configuration
HANDLE hRouterInterface, // handle to the interface configuration
DWORD dwTransportId, // identifier of the transport/router
// manager
LPWSTR lpwsTransportName, // transport name
LPBYTE pInterfaceInfo, // interface information
DWORD dwInterfaceInfoSize, // size of interface information
HANDLE *phRouterIfTransport // handle to transport configuration
);
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:
|
| ERROR_NOT_ENOUGH_MEMORY | Insufficient resources to complete the operation. |
| Other | Use FormatMessage to retrieve the system error message that corresponds to the error code returned. |
In addition to specifying a transport, the dwTransportId parameter also specifies a router manager, because a Windows 2000 router maintains a unique router manager for each transport.
If the specified transport already exists, MprConfigInterfaceTransportAdd does the equivalent of an MprConfigInterfaceTransportSetInfo call using the specified parameter values.
Windows NT/2000: Requires Windows 2000.
Header: Declared in Mprapi.h.
Library: Use Mprapi.lib.
Router Management Reference, Router Configuration Functions, FormatMessage, MPR_IFTRANSPORT_0, MprConfigInterfaceCreate, MprConfigInterfaceEnum, MprConfigInterfaceGetHandle, MprConfigServerConnect