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 CALLBACK MprAdminAcceptNewLink(
  __in  RAS_PORT_0 *pRasPort0,
  __in  RAS_PORT_1 *pRasPort1
);

Parameters

pRasPort0 [in]

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

pRasPort1 [in]

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

See Also

Remote Access Service Administration Reference
RAS Administration Functions
RAS Administration DLL
MprAdminAcceptNewConnection
MprAdminConnectionHangupNotification
MprAdminLinkHangupNotification
RAS_PORT_0
RAS_PORT_1

Send comments about this topic to Microsoft

Build date: 7/8/2008