структура 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 должен содержать по крайней мере одно из следующих значений.
| Значение | Значение |
|---|---|
|
Для подключения используется протокол "точка — точка" (PPP). |
|
Служба messenger активна на клиенте, и сообщения можно отправлять клиенту с помощью функции MprAdminSendUserMessage . |
|
Подключение в настоящее время находится в карантине. Сведения о том, как удалить подключение из карантина, см. в разделе MprAdminConnectionRemoveQuarantine. |
|
Для подключения используется протокол удаленного доступа AppleTalk (ARAP). |
|
Для подключения используется IKEv2. |
|
Соединение использует 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-подключения. В следующей таблице показаны возможные значения для этого элемента.
| Значение | Значение |
|---|---|
|
Туннель типа "точка — точка" (PPTP) |
|
Туннель L2TP |
|
Туннель SSTP |
|
Туннель IKEv2 |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows Server 2012 [только классические приложения] |
| Верхняя часть | mprapi.h |