The MprConfigInterfaceTransportSetInfo function updates the configuration information for the client on the specified interface and transport.
DWORD MprConfigInterfaceTransportSetInfo( HANDLE hMprConfig, // handle to the router configuration HANDLE hRouterInterface, // handle to the interface configuration HANDLE hRouterIfTransport, // handle to the transport configuration LPBYTE pInterfaceInfo, // configuration information for transport // and interface DWORD dwInterfaceInfoSize // size of configuration information );
This parameter is optional. If the calling application specifies NULL for this parameter, the function does not update the configuration information for the client.
This parameter is optional; the calling application may specify zero for this parameter. However, if pInterfaceInfo is not NULL, this parameter cannot be zero. For more information, see the Remarks section later in this topic.
If the function succeeds, the return value is NO_ERROR. For more information, see the Remarks section later in this topic.
If the function fails, the return value is one of the following error codes.
Value | Meaning |
---|---|
ERROR_INVALID_PARAMETER | At least one of the following is true:
|
ERROR_NO_SUCH_INTERFACE | The interface specified by hRouterInterface is no longer present in the router configuration, or the transport specified by hRouterIfTransport is no longer present on the interface. |
Other | Use FormatMessage to retrieve the system error message that corresponds to the error code returned. |
If the pInterfaceInfo parameter is NULL, MprConfigInterfaceTransportSetInfo does nothing and returns immediately with a value of NO_ERROR.
Windows NT/2000: Requires Windows 2000.
Header: Declared in Mprapi.h.
Library: Use Mprapi.lib.
Router Management Reference, Router Configuration Functions, FormatMessage, MprConfigInterfaceCreate, MprConfigInterfaceEnum, MprConfigInterfaceGetHandle, MprConfigInterfaceTransportEnum, MprConfigInterfaceTransportGetHandle, MprConfigServerConnect