The MprConfigTransportCreate function adds the specified transport to the list of transports present in the specified router configuration.
DWORD MprConfigTransportCreate(
HANDLE hMprConfig, // handle to the router configuration
DWORD dwTransportId, // identifier of the transport/router
// manager
LPWSTR lpwsTransportName, // address of the transport name
LPBYTE pGlobalInfo, // address of the global info
DWORD dwGlobalInfoSize, // size of the global info buffer
LPBYTE pClientInterfaceInfo, // address of info for client routers
DWORD dwClientInterfaceInfoSize, // size of the client info buffer
LPWSTR lpwsDLLPath, // address of the router manager
// DLL name
HANDLE phRouterTransport // handle to the transport configuration
);
This parameter is optional; the calling application may specify NULL for this parameter.
This parameter is optional; the calling application may specify NULL for this parameter.
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 | The hMprConfig parameter is NULL, or the phRouterTransport parameter is NULL, or both are NULL. |
| 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. |
If the specified transport already exists, MprConfigTransportCreate does the equivalent of an MprConfigTransportSetInfo call using the supplied parameter values.
Windows NT/2000: Requires Windows 2000.
Header: Declared in Mprapi.h.
Library: Use Mprapi.lib.
Router Management Reference, Router Configuration Functions, FormatMessage, MprConfigServerConnect