MprConfigServerSetInfoEx function

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

Syntax


DWORD APIENTRY MprConfigServerSetInfo(
  _In_ HANDLE                   hMprConfig,
  _In_ MPR_SERVER_SET_CONFIG_EX *pSetServerConfig
);

Parameters

hMprConfig [in]

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

pSetServerConfig [in]

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.

ValueMeaning
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 affect on a RRAS server until it is restarted.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Mprapi.h

Library

Mprapi.lib

DLL

Mprapi.dll

See also

Router Configuration Functions
Router Management Reference
MprConfigBufferFree
MprConfigServerConnect
MprConfigServerGetInfo

 

 

Community Additions

ADD
Show: