Поделиться через


структура RAS_CONNECTION_4 (mprapi.h)

Содержит конкретные сведения о подключении, включая: имя пользователя, домен, глобальный уникальный идентификатор (GUID), связанный с подключением, состояние карантина защиты доступа к сети (NAP), статистику пакетов, а также сведения, связанные с ним (PPP) и Internet Key Exchange версии 2 (IKEv2).

Синтаксис

typedef struct _RAS_CONNECTION_4 {
  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];
  GUID                  guid;
  RAS_QUARANTINE_STATE  rasQuarState;
  FILETIME              probationTime;
  FILETIME              connectionStartTime;
  ULONGLONG             ullBytesXmited;
  ULONGLONG             ullBytesRcved;
  DWORD                 dwFramesXmited;
  DWORD                 dwFramesRcved;
  DWORD                 dwCrcErr;
  DWORD                 dwTimeoutErr;
  DWORD                 dwAlignmentErr;
  DWORD                 dwHardwareOverrunErr;
  DWORD                 dwFramingErr;
  DWORD                 dwBufferOverrunErr;
  DWORD                 dwCompressionRatioIn;
  DWORD                 dwCompressionRatioOut;
  DWORD                 dwNumSwitchOvers;
  WCHAR                 wszRemoteEndpointAddress[MAXIPADRESSLEN + 1];
  WCHAR                 wszLocalEndpointAddress[MAXIPADRESSLEN + 1];
  PROJECTION_INFO2      ProjectionInfo;
  HANDLE                hConnection;
  HANDLE                hInterface;
  DWORD                 dwDeviceType;
} RAS_CONNECTION_4, *PRAS_CONNECTION_4;

Члены

dwConnectDuration

Значение типа , представляющее длительность соединения в секундах.

dwInterfaceType

Перечисление ROUTER_INTERFACE_TYPE , определяющее тип интерфейса подключения.

dwConnectionFlags

Растровое изображение флагов, указывающих атрибуты подключения. Член dwConnectionFlags должен содержать по крайней мере одно из следующих значений.

Значение Значение
RAS_FLAGS_PPP_CONNECTION
0x00000001
Для подключения используется протокол "точка — точка" (PPP).
RAS_FLAGS_MESSENGER_PRESENT
0x00000002
Служба messenger активна на клиенте, и сообщения можно отправлять клиенту с помощью функции MprAdminSendUserMessage .
RAS_FLAGS_QUARANTINE_PRESENT
0x00000008
Подключение в настоящее время находится в карантине. Сведения о том, как удалить подключение из карантина, см. в разделе MprAdminConnectionRemoveQuarantine.
RAS_FLAGS_ARAP_CONNECTION
0x00000010
Для подключения используется протокол удаленного доступа AppleTalk (ARAP).
RAS_FLAGS_IKEV2_CONNECTION
0x00000010
Для подключения используется IKEv2.
RAS_FLAGS_DORMANT
0x00000020
Соединение использует IKEv2, и сервер недоступен.

wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]

Строка Юникода, завершающаяся нулевым значением, которая содержит имя интерфейса для этого соединения.

wszUserName[UNLEN + 1]

Строка Юникода со значением NULL, содержащая имя пользователя, вошедшего в соединение.

wszLogonDomain[DNLEN + 1]

Строка Юникода с символом NULL, содержащая домен, в котором выполняется проверка подлинности подключенного пользователя.

wszRemoteComputer[NETBIOS_NAME_LEN + 1]

Строка Юникода, завершающаяся нулевым значением, которая содержит имя удаленного компьютера.

guid

Guid, идентифицирующий соединение. Для входящих подключений этот GUID действителен только при условии, что подключение активно.

rasQuarState

Структура RAS_QUARANTINE_STATE , указывающая состояние карантина NAP подключения.

probationTime

Структура FILETIME , указывающая время, необходимое для выхода подключения из карантина, после которого подключение будет удалено. Это значение допустимо, только если член rasQuarState имеет значение RAS_QUAR_STATE_PROBATION.

connectionStartTime

Структура FILETIME , указывающая время начала подключения в формате UTC.

ullBytesXmited

Значение типа , указывающее количество байтов, передаваемых по соединению.

ullBytesRcved

Значение типа , указывающее количество байтов, полученных при подключении.

dwFramesXmited

Значение типа , указывающее количество кадров, передаваемых при соединении.

dwFramesRcved

Значение типа , указывающее количество кадров, полученных при соединении.

dwCrcErr

Значение типа , указывающее количество ошибок циклической проверки избыточности (CRC) в подключении.

dwTimeoutErr

Значение типа , указывающее количество ошибок времени ожидания подключения.

dwAlignmentErr

Значение типа , указывающее количество ошибок выравнивания при подключении.

dwHardwareOverrunErr

Значение типа , указывающее количество ошибок переполнения оборудования при подключении.

dwFramingErr

Значение типа , указывающее количество ошибок обрамления в соединении.

dwBufferOverrunErr

Значение типа , указывающее количество ошибок переполнения буфера в подключении.

dwCompressionRatioIn

Значение типа , указывающее процент сжатия данных, полученных в этом соединении. Член dwCompressionRatioIn — это размер сжатых данных, деленных на размер одних и те же данных в несжатом состоянии.

dwCompressionRatioOut

Значение типа , указывающее процент сжатия данных, передаваемых по этому соединению. Соотношение — это размер сжатых данных, деленных на размер одних и те же данных в несжатом состоянии.

dwNumSwitchOvers

Значение типа , указывающее количество коммутаторов IKEv2 Mobility and Multihoming Protocol (MOBIKE), которые произошли при подключении. Член dwNumSwitchOvers действителен , только если элемент dwConnectionFlags является RAS_FLAGS_IKEV2_CONNECTION.

wszRemoteEndpointAddress[MAXIPADRESSLEN + 1]

Строка Юникода, завершающаяся null, которая содержит IP-адрес удаленного компьютера в подключении. Эта строка имеет вид "a.b.c.d".

wszLocalEndpointAddress[MAXIPADRESSLEN + 1]

Строка Юникода, завершающаяся null, которая содержит IP-адрес локального компьютера в соединении. Эта строка имеет вид "a.b.c.d".

ProjectionInfo

Структура PROJECTION_INFO2 , содержащая структуру PPP_PROJECTION_INFO2 или структуру IKEV2_PROJECTION_INFO2 .

hConnection

Дескриптор для подключения RAS.

hInterface

Дескриптор интерфейса подключения RAS.

dwDeviceType

Значение типа , указывающее тип туннеля VPN-подключения. В следующей таблице показаны возможные значения для этого элемента.

Значение Значение
RDT_Tunnel_Pptp
Туннель типа "точка — точка" (PPTP)
RDT_Tunnel_L2tp
Туннель L2TP
RDT_Tunnel_Sstp
Туннель SSTP
RDT_Tunnel_IKev2
Туннель IKEv2

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Верхняя часть mprapi.h