MprConfigServerSetInfoEx function (mprapi.h)

The MprConfigServerSetInfoEx function sets port information on a specified RRAS server.

Syntax

DWORD MprConfigServerSetInfoEx(
  [in] HANDLE                   hMprConfig,
  [in] MPR_SERVER_SET_CONFIG_EX *pSetServerConfig
);

Parameters

[in] hMprConfig

A handle to the router configuration. Obtain this handle by calling MprConfigServerConnect.

[in] pSetServerConfig

A pointer to a MPR_SERVER_SET_CONFIG_EX structure that contains the port information being set on the server in hMprServer.

Return value

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_ACCESS_DENIED
The calling application does not have sufficient privileges.
ERROR_INVALID_PARAMETER
The pSetServerConfig parameter is NULL or the Header field values are erroneous.
ERROR_DDM_NOT_RUNNING
The Demand Dial Manager (DDM) is not running.
Other
Use FormatMessage to retrieve the system error message that corresponds to the error code returned.

Remarks

These changes to a server configuration are persistent, but have no effect on a RRAS server until it is restarted.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header mprapi.h
Library Mprapi.lib
DLL Mprapi.dll

See also

MprConfigBufferFree

MprConfigServerConnect

MprConfigServerGetInfo

Router Configuration Functions

Router Management Reference