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