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

Статья
08/24/2023

Структура PPP_PROJECTION_INFO содержит сведения, полученные во время согласования "точка — точка" (PPP) для протокола SSTP, протокола PPTP и протокола туннелирования уровня 2 (L2TP).

Синтаксис

typedef struct _PPP_PROJECTION_INFO {
  DWORD   dwIPv4NegotiationError;
  WCHAR   wszAddress[IPADDRESSLEN + 1];
  WCHAR   wszRemoteAddress[IPADDRESSLEN + 1];
  DWORD   dwIPv4Options;
  DWORD   dwIPv4RemoteOptions;
  ULONG64 IPv4SubInterfaceIndex;
  DWORD   dwIPv6NegotiationError;
  BYTE    bInterfaceIdentifier[8];
  BYTE    bRemoteInterfaceIdentifier[8];
  BYTE    bPrefix[8];
  DWORD   dwPrefixLength;
  ULONG64 IPv6SubInterfaceIndex;
  DWORD   dwLcpError;
  DWORD   dwAuthenticationProtocol;
  DWORD   dwAuthenticationData;
  DWORD   dwRemoteAuthenticationProtocol;
  DWORD   dwRemoteAuthenticationData;
  DWORD   dwLcpTerminateReason;
  DWORD   dwLcpRemoteTerminateReason;
  DWORD   dwLcpOptions;
  DWORD   dwLcpRemoteOptions;
  DWORD   dwEapTypeId;
  DWORD   dwRemoteEapTypeId;
  DWORD   dwCcpError;
  DWORD   dwCompressionAlgorithm;
  DWORD   dwCcpOptions;
  DWORD   dwRemoteCompressionAlgorithm;
  DWORD   dwCcpRemoteOptions;
} PPP_PROJECTION_INFO, *PPPP_PROJECTION_INFO;

Члены

dwIPv4NegotiationError

Значение типа , указывающее результат согласования протокола управления сетью PPP IPv4. Нулевое значение указывает, что ipv4 успешно согласован. Ненулевое значение указывает на сбой и является неустранимой ошибкой, которая произошла во время согласования протокола управления.

wszAddress[IPADDRESSLEN + 1]

Массив, содержащий строку Юникода, задающую IPv4-адрес локального клиента. Эта строка имеет вид "a.b.c.d". wszAddress является допустимым , только если dwIPv4NegotiationError равно нулю.

wszRemoteAddress[IPADDRESSLEN + 1]

Массив, содержащий строку Юникода, которая указывает IPv4-адрес удаленного сервера. Эта строка имеет вид "a.b.c.d". wszRemoteAddress действителен , только если dwIPv4NegotiationError равно нулю. Если адрес недоступен, этот элемент является пустой строкой.

dwIPv4Options

Значение типа , указывающее параметры IPCP для локального клиента.

Значение	Значение
PPP_IPCP_VJ	Указывает, что ip-датаграммы, отправленные локальным клиентом, сжимаются с помощью сжатия Ван Джейкобсона.

dwIPv4RemoteOptions

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

Значение	Значение
PPP_IPCP_VJ	Указывает, что ip-датаграммы, отправленные удаленным сервером (то есть полученные локальным компьютером), сжимаются с помощью сжатия Ван Джейкобсона.

IPv4SubInterfaceIndex

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

dwIPv6NegotiationError

Значение типа , указывающее результат согласования протокола управления сетью PPP IPv6. Значение , равное нулю, указывает, что ipv6 успешно согласован. Ненулевое значение указывает на сбой и является неустранимой ошибкой, которая произошла во время согласования протокола управления.

bInterfaceIdentifier[8]

Массив, указывающий идентификатор 64-разрядного интерфейса IPv6 клиента. Последние 64 бита 128-разрядного IPv6-адреса считаются идентификатором интерфейса, который обеспечивает высокий уровень уникальности для предыдущих 64-разрядных версий. bInterfaceIdentifier действителен , только если dwIPv6NegotiationError равно нулю и не должен быть равен нулю.

bRemoteInterfaceIdentifier[8]

Массив, указывающий идентификатор 64-разрядного интерфейса IPv6 сервера. Последние 64 бита 128-разрядного IPv6-адреса считаются идентификатором интерфейса, который обеспечивает высокий уровень уникальности для предыдущих 64-разрядных версий. bInterfaceIdentifier действителен , только если dwIPv6NegotiationError равно нулю и не должен быть равен нулю.

bPrefix[8]

Значение типа , указывающее префикс IPv6-адреса клиентского интерфейса.

dwPrefixLength

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

IPv6SubInterfaceIndex

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

dwLcpError

Значение типа , указывающее результат согласования PPP LCP. Значение, равное нулю, указывает на успешное согласование LCP. Ненулевое значение указывает на сбой и является неустранимой ошибкой, которая произошла во время согласования протокола управления.

dwAuthenticationProtocol

Значение типа , указывающее протокол проверки подлинности, используемый для проверки подлинности локального клиента. Этот элемент может иметь одно из следующих значений.

Значение	Значение
PPP_LCP_PAP	Протокол проверки подлинности паролей.
PPP_LCP_CHAP	Протокол проверки подлинности подтверждения запроса.
PPP_LCP_EAP	Расширяемый протокол проверки подлинности.

dwAuthenticationData

Значение типа , указывающее дополнительные сведения о протоколе проверки подлинности, заданном dwAuthenticationProtocol. Этот элемент может иметь одно из следующих значений:

Значение	Значение
PPP_LCP_CHAP_MD5	MD5 CHAP
PPP_LCP_CHAP_MS	Microsoft CHAP.
PPP_LCP_CHAP_MSV2	Microsoft CHAP версии 2.

dwRemoteAuthenticationProtocol

Значение типа , указывающее протокол проверки подлинности, используемый для проверки подлинности удаленного сервера. DwAuthenticationProtocol и dwRemoteAuthenticationProtocol будут отличаться, если для вызова по запросу используются разные протоколы проверки подлинности на клиенте и сервере. Этот элемент может иметь одно из следующих значений:

Значение	Значение
PPP_LCP_PAP	Протокол проверки подлинности паролей.
PPP_LCP_CHAP	Протокол проверки подлинности подтверждения запроса.
PPP_LCP_EAP	Расширяемый протокол проверки подлинности.

dwRemoteAuthenticationData

Значение типа , указывающее дополнительные сведения о протоколе проверки подлинности, заданном параметром dwRemoteAuthenticationProtocol. DwAuthenticationData и dwRemoteAuthenticationData будут отличаться, если для набора по запросу используются разные протоколы проверки подлинности на клиенте и сервере. Этот элемент может иметь одно из следующих значений:

Значение	Значение
PPP_LCP_CHAP_MD5	MD5 CHAP.
PPP_LCP_CHAP_MS	Microsoft CHAP.
PPP_LCP_CHAP_MSV2	Microsoft CHAP версии 2.

dwLcpTerminateReason

Зарезервировано для последующего использования. Должен равняться нулю.

dwLcpRemoteTerminateReason

Зарезервировано для последующего использования. Должен равняться нулю.

dwLcpOptions

Значение типа , указывающее сведения о параметрах LCP, используемых локальным клиентом. Этот элемент представляет собой сочетание следующих флагов:

Значение	Значение
PPP_LCP_MULTILINK_FRAMING	Для подключения используется многоканавая связь.
PPP_LCP_PFC	Для подключения используется протокол сжатия полей (RFC 1172).
PPP_LCP_ACFC	Для подключения используется сжатие поля адреса и управления (RFC 1172).
PPP_LCP_SSHF	Соединение использует формат заголовка короткого порядкового номера (см. RFC 1990).
PPP_LCP_DES_56	Подключение использует 56-разрядное шифрование DES.
PPP_LCP_3_DES	Подключение использует тройное шифрование DES.
PPP_LCP_AES_128	Подключение использует 128-разрядное шифрование AES.
PPP_LCP_AES_256	Подключение использует 256-разрядное шифрование AES.

dwLcpRemoteOptions

Значение типа , указывающее сведения о параметрах LCP, используемых удаленным сервером. Этот элемент представляет собой сочетание следующих флагов:

Значение	Значение
PPP_LCP_MULTILINK_FRAMING	Для подключения используется многоканавая связь.
PPP_LCP_PFC	Соединение использует сжатие полей протокола (RFC 1172).
PPP_LCP_ACFC	Для подключения используется сжатие поля адреса и управления (RFC 1172).
PPP_LCP_SSHF	Соединение использует формат заголовка короткого порядкового номера (см. RFC 1990).
PPP_LCP_DES_56	Подключение использует 56-разрядное шифрование DES.
PPP_LCP_3_DES	Подключение использует тройное шифрование DES.
PPP_LCP_AES_128	Подключение использует 128-разрядное шифрование AES
PPP_LCP_AES_256	Подключение использует 256-разрядное шифрование AES.

dwEapTypeId

Значение типа , указывающее идентификатор типа протокола EAP, используемого для проверки подлинности локального клиента. Значение этого элемента допустимо, только если параметр dwAuthenticationProtocolимеет значение PPP_LCP_EAP.

dwRemoteEapTypeId

Значение типа , указывающее идентификатор типа протокола EAP, используемого для проверки подлинности удаленного сервера. Значение этого элемента допустимо, только если параметр dwRemoteAuthenticationProtocolPPP_LCP_EAP.

dwCcpError

Значение типа , указывающее результат согласования CCP PPP. Нулевое значение указывает на успешное согласование CCP. Ненулевое значение указывает на сбой и является неустранимой ошибкой, которая произошла во время согласования протокола управления.

dwCompressionAlgorithm

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

Значение	Значение
RASCCPCA_MPPC	Протокол MICROSOFT MPPC (RFC 2118).
RASCCPCA_STAC	Параметр STAC 4 (RFC 1974).

dwCcpOptions

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

Значение	Значение
PPP_CCP_COMPRESSION	Сжатие без шифрования.
PPP_CCP_HISTORYLESS	Шифрование "точка — точка" (Майкрософт) в режиме без отслеживания состояния. Ключ сеанса изменяется после каждого пакета. Этот режим повышает производительность сетей с высокой задержкой или сетей со значительной потерей пакетов.
PPP_CCP_ENCRYPTION40BITOLD	Сжатие MPPE с использованием 40-разрядных ключей.
PPP_CCP_ENCRYPTION40BIT	Сжатие MPPE с использованием 40-разрядных ключей.
PPP_CCP_ENCRYPTION56BIT	Сжатие MPPE с использованием 56-разрядных ключей.
PPP_CCP_ENCRYPTION128BIT	Сжатие MPPE с использованием 128-разрядных ключей.

Последние три параметра используются, когда соединение выполняется по протоколу L2TP, а подключение использует шифрование IPSec.

dwRemoteCompressionAlgorithm

Значение типа , указывающее алгоритм сжатия, используемый удаленным сервером. Поддерживаются следующие алгоритмы:

Значение	Значение
RASCCPCA_MPPC	Протокол MICROSOFT MPPC ( RFC 2118).
RASCCPCA_STAC	Вариант STAC 4 ( RFC 1974).

dwCcpRemoteOptions

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

Значение	Значение
PPP_CCP_COMPRESSION	Сжатие без шифрования.
PPP_CCP_HISTORYLESS	Шифрование "точка — точка" (Майкрософт) в режиме без отслеживания состояния. Ключ сеанса изменяется после каждого пакета. Этот режим повышает производительность сетей с высокой задержкой или сетей со значительной потерей пакетов.
PPP_CCP_ENCRYPTION40BITOLD	Сжатие MPPE с использованием 40-разрядных ключей.
PPP_CCP_ENCRYPTION40BIT	Сжатие MPPE с использованием 40-разрядных ключей.
PPP_CCP_ENCRYPTION56BIT	Сжатие MPPE с использованием 56-разрядных ключей.
PPP_CCP_ENCRYPTION128BIT	Сжатие MPPE с использованием 128-разрядных ключей.
ERROR_PPP_NOT_CONVERGING	Удаленный компьютер и RRAS не могут сходиться при согласовании адресов.

Требования

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

См. также раздел

Справочник по управлению маршрутизатором

Структуры управления маршрутизаторами

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

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

Синтаксис

Члены

Требования

См. также раздел

Обратная связь

Дополнительные ресурсы