MprAdminAcceptNewConnection3 function (mprapi.h)

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

Syntax

BOOL MprAdminAcceptNewConnection3(
  [in] RAS_CONNECTION_0 *pRasConnection0,
  [in] RAS_CONNECTION_1 *pRasConnection1,
  [in] RAS_CONNECTION_2 *pRasConnection2,
  [in] RAS_CONNECTION_3 *pRasConnection3
);

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.

[in] pRasConnection2

Pointer to a RAS_CONNECTION_2 structure that describes this connection.

[in] pRasConnection3

Pointer to a RAS_CONNECTION_3 structure that describes this connection.

Return value

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

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

Remarks

RAS supports multiple Administration DLLs. RAS calls the multiple implementations of the MprAdminAcceptNewConnection3 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 MprAdminAcceptNewConnection3 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.

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

Requirements

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

See also

MprAdminAcceptNewConnection

MprAdminAcceptNewConnection2

MprAdminConnectionHangupNotification2

RAS Administration DLL

RAS Administration Functions

RAS_CONNECTION_0

RAS_CONNECTION_1

RAS_CONNECTION_2

RAS_CONNECTION_3

Remote Access Service Administration Reference