структура RAS_CONNECTION_EX (mprapi.h)
Структура RAS_CONNECTION_EX содержит конкретные сведения для подключения, включая: имя пользователя, домен и глобальный уникальный идентификатор (GUID), связанные с подключением, состояние карантина защиты доступа к сети (NAP), статистику пакетов, а также сведения, связанные с протоколом "точка — точка" (PPP) и Internet Key Exchange версии 2 (IKEv2).
Структура RAS_CONNECTION_EX содержит большую часть той же информации, что и RAS_CONNECTION_0, RAS_CONNECTION_1, RAS_CONNECTION_2 и RAS_CONNECTION_3 объединенные структуры.
Синтаксис
typedef struct _RAS_CONNECTION_EX {
MPRAPI_OBJECT_HEADER Header;
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;
DWORD dwBytesXmited;
DWORD dwBytesRcved;
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_INFO ProjectionInfo;
HANDLE hConnection;
HANDLE hInterface;
} RAS_CONNECTION_EX, *PRAS_CONNECTION_EX;
Члены
Header
Структура MPRAPI_OBJECT_HEADER , указывающая версию структуры RAS_CONNECTION_EX .
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.
dwBytesXmited
Значение типа , указывающее количество байтов, передаваемых по соединению.
dwBytesRcved
Значение типа , указывающее количество байтов, полученных при подключении.
dwFramesXmited
Значение типа , указывающее количество кадров, передаваемых при соединении.
dwFramesRcved
Значение типа , указывающее количество кадров, полученных при соединении.
dwCrcErr
Значение типа , указывающее количество ошибок циклической проверки избыточности (CRC) в подключении.
dwTimeoutErr
Значение типа , указывающее количество ошибок времени ожидания подключения.
dwAlignmentErr
Значение типа , указывающее количество ошибок выравнивания при подключении.
dwHardwareOverrunErr
Значение типа , указывающее количество ошибок переполнения оборудования при подключении.
dwFramingErr
Значение типа , указывающее количество ошибок обрамления в соединении.
dwBufferOverrunErr
Значение типа , указывающее количество ошибок переполнения буфера в подключении.
dwCompressionRatioIn
Значение типа , указывающее процент сжатия данных, полученных в этом соединении. dwCompressionRatioIn — это размер сжатых данных, деленных на размер одних и те же данных в несжатом состоянии.
dwCompressionRatioOut
Значение типа , указывающее процент сжатия данных, передаваемых по этому соединению. Соотношение — это размер сжатых данных, деленных на размер одних и те же данных в несжатом состоянии.
dwNumSwitchOvers
Значение типа , указывающее количество коммутаторов IKEv2 Mobility and Multihoming Protocol (MOBIKE), которые произошли при подключении, как определено в RFC4555. Параметр dwNumSwitchOvers действителен , только если параметр dwConnectionFlagsRAS_FLAGS_IKEV2_CONNECTION.
wszRemoteEndpointAddress[MAXIPADRESSLEN + 1]
Строка Юникода, завершающаяся null, которая содержит IP-адрес удаленного компьютера в подключении. Эта строка имеет вид "a.b.c.d".
wszLocalEndpointAddress[MAXIPADRESSLEN + 1]
Строка Юникода, завершающаяся null, которая содержит IP-адрес локального компьютера в соединении. Эта строка имеет вид "a.b.c.d".
ProjectionInfo
Структура PROJECTION_INFO , содержащая структуру PPP_PROJECTION_INFO или IKEV2_PROJECTION_INFO .
hConnection
Дескриптор для подключения RAS.
hInterface
Дескриптор интерфейса подключения RAS.
Требования
| Минимальная версия клиента | Windows 7 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 R2 [только классические приложения] |
| Верхняя часть | mprapi.h |