MprAdminEstablishDomainRasServer function (mprapi.h)

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