MprAdminAcceptNewLink function (mprapi.h)

Remote Access Service (RAS) calls the MprAdminAcceptNewLink function each time a link is created for a particular connection. RAS calls this function once immediately after MprAdminAcceptNewConnection returns, and an additional time for every new link that is to be used with the connection.

Syntax

BOOL MprAdminAcceptNewLink(
  [in] RAS_PORT_0 *pRasPort0,
  [in] RAS_PORT_1 *pRasPort1
);

Parameters

[in] pRasPort0

Pointer to a RAS_PORT_0 structure that describes the port being used by the link.

[in] pRasPort1

Pointer to a RAS_PORT_1 structure that describes the port being used by the link.

Return value

If RAS should accept the new link, the return value should be TRUE.

If RAS should not accept the new link, the return value should be FALSE.

Remarks

RAS supports multiple Administration DLLs. RAS calls the multiple implementations of MprAdminAcceptNewLink in the order in which the DLLs are listed in the registry. The remote-access user is allowed to connect only if the implementation of MprAdminAcceptNewLink in each of the DLLs accepts the connection. In other words, every DLL must accept the link in order for the link to be established.

Windows 2000 Server and earlier:  If RAS does not accept the new link, RAS does not call the MprAdminLinkHangupNotification function.

Do not call any of the RAS Administration Functions or RAS User Administration Functions from inside MprAdminAcceptNewLink. Calls to these functions do not return when made from within a callout function.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header mprapi.h

See also

MprAdminAcceptNewConnection

MprAdminConnectionHangupNotification

MprAdminLinkHangupNotification

RAS Administration DLL

RAS Administration Functions

RAS_PORT_0

RAS_PORT_1

Remote Access Service Administration Reference