MprAdminAcceptNewConnection function (mprapi.h)

Remote Access Service calls the MprAdminAcceptNewConnection function each time a new user dials in and successfully completes RAS authentication. MprAdminAcceptNewConnection determines whether the user is allowed to connect.

Syntax

BOOL MprAdminAcceptNewConnection(
  [in] RAS_CONNECTION_0 *pRasConnection0,
  [in] RAS_CONNECTION_1 *pRasConnection1
);

Parameters

[in] pRasConnection0

Pointer to a RAS_CONNECTION_0 structure that describes this connection.

[in] pRasConnection1

Pointer to a RAS_CONNECTION_1 structure that describes this connection.

Return value

If MprAdminAcceptNewConnection accepts the connection, the return value should be TRUE.

If MprAdminAcceptNewConnection rejects the connection, the return value should be FALSE.

Remarks

RAS supports multiple Administration DLLs. RAS calls the multiple implementations of the MprAdminAcceptNewConnection function 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 MprAdminAcceptNewConnection in each of the DLLs accepts the connection. In other words, every DLL must accept the connection in order for the user to be allowed to connect.

Windows 2000 Server and earlier:  If MprAdminAcceptNewConnection does not accept the new connection, RAS does not call the MprAdminConnectionHangupNotification function.

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

Requirements

See also

MprAdminAcceptNewConnection2

MprAdminAcceptNewConnection3

MprAdminConnectionHangupNotification

MprAdminConnectionHangupNotification2

RAS Administration DLL

RAS Administration Functions

RAS_CONNECTION_0

RAS_CONNECTION_1

Remote Access Service Administration Reference