Edit

MprAdminEstablishDomainRasServer function (mprapi.h)

  • Article

The MprAdminEstablishDomainRasServer function establishes the given machine as a Remote Access Server in the domain. This function must be executed only on a machine joined to a domain.

Syntax

DWORD MprAdminEstablishDomainRasServer(
  [in] LPWSTR pszDomain,
  [in] LPWSTR pszMachine,
  [in] BOOL   bEnable
);

Parameters

[in] pszDomain

The domain in which you want the server to be advertised.

[in] pszMachine

The name of the RAS server.

[in] bEnable

A BOOL that is TRUE if the RAS server should be advertised in the domain. Otherwise, it is FALSE.

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_DS_SERVER_DOWN
 pszDomain is invalid.
ERROR_NOT_FOUND
 pszMachine is invalid.
ERROR_DS_OPERATIONS_ERROR
 User is a non-domain user.
ERROR_NO_SUCH_DOMAIN
 Function executed on a machine not joined to any domain.

Requirements

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

See also

Router Administration Functions

Router Management Reference