Edit

RAS_CONNECTION_0 structure (mprapi.h)

  • Article

The RAS_CONNECTION_0 structure contains general information regarding a specific connection, such as user name or domain. For more detailed information about a specific connection, such as bytes sent or received, see RAS_CONNECTION_1.

Syntax

typedef struct _RAS_CONNECTION_0 {
  HANDLE                hConnection;
  HANDLE                hInterface;
  DWORD                 dwConnectDuration;
  ROUTER_INTERFACE_TYPE dwInterfaceType;
  DWORD                 dwConnectionFlags;
  WCHAR                 wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1];
  WCHAR                 wszUserName[UNLEN + 1];
  WCHAR                 wszLogonDomain[DNLEN + 1];
  WCHAR                 wszRemoteComputer[NETBIOS_NAME_LEN + 1];
} RAS_CONNECTION_0, *PRAS_CONNECTION_0;

Members

hConnection

A handle to the connection.

hInterface

A handle to the interface.

dwConnectDuration

A value that represent the duration of the connection, in seconds.

dwInterfaceType

A ROUTER_INTERFACE_TYPE enumeration that identifies the type of connection interface.

dwConnectionFlags

A bitmap of flags that specify connection attributes. dwConnectionFlags must contain at least one of the following values:

Value Meaning
RAS_FLAGS_PPP_CONNECTION
0x00000001
 The connection is using Point-to-Point Protocol (PPP).
RAS_FLAGS_MESSENGER_PRESENT
0x00000002
 The messenger service is active on the client and messages can be sent to the client using MprAdminSendUserMessage.
RAS_FLAGS_QUARANTINE_PRESENT
0x00000008
 The connection is currently in quarantine. For information on how to remove the connection from quarantine, please see MprAdminConnectionRemoveQuarantine.
RAS_FLAGS_ARAP_CONNECTION
0x00000010
 The connection is using AppleTalk Remote Access Protocol (ARAP).
RAS_FLAGS_IKEV2_CONNECTION
0x00000010
 The connection is using IKEv2.
RAS_FLAGS_DORMANT
0x00000020
 The connection is using IKEv2 and the server is not reachable.

wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]

A null-terminated Unicode string that contains the name of the interface for this connection.

wszUserName[UNLEN + 1]

A null-terminated Unicode string that contains the name of the user logged on to the connection.

wszLogonDomain[DNLEN + 1]

A null-terminated Unicode string that contains the domain on which the connected user is authenticated.

wszRemoteComputer[NETBIOS_NAME_LEN + 1]

A null-terminated Unicode string that contains the name of the remote computer.

Requirements

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

See also

MprAdminAcceptReauthentication

MprAdminConnectionEnum

MprAdminConnectionHangupNotification3

RAS Administration Structures

RAS_CONNECTION_1

RAS_CONNECTION_2

RAS_CONNECTION_3

Remote Access Service Administration Reference