MprConfigServerInstall function (mprapi.h)

The MprConfigServerInstall function configures Routing and Remote Access Service with a default configuration.

Syntax

DWORD MprConfigServerInstall(
  [in] DWORD dwLevel,
  [in] PVOID pBuffer
);

Parameters

[in] dwLevel

This parameter is reserved for future use, and should be zero.

[in] pBuffer

This parameter is reserved for future use, and should be NULL.

Return value

If the functions succeeds, the return value is ERROR_SUCCESS.

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:
  • dwLevel is not zero.
  • pBuffer is non-NULL.

Remarks

The MprConfigServerInstall function performs the following tasks:

  • Resets the current Router Manager and Interface keys.
  • Initializes RAS structures for IP.
  • Sets the router type to include:

    ROUTER_TYPE_RAS

    ROUTER_TYPE_WAN

    ROUTER_TYPE_LAN

  • Sets the error logging level and authorization settings to defaults.
  • Sets the devices for Routing and RAS.
  • Adds the RRAS snap-in to the computer management console.
  • Deletes the router phone book.
  • Registers the router in the domain.
  • Writes out the router is configured registry key.
The MprConfigServerInstall function does not start Routing and RAS or set the service start type for Routing and RAS.

Requirements

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

See also

Windows 2000 Registry Layout