estructura PPP_PROJECTION_INFO (mprapi.h)

Artículo
08/24/2023

La estructura de PPP_PROJECTION_INFO contiene información obtenida durante la negociación de punto a punto (PPP) para el Protocolo de túnel de sockets seguros (SSTP), el protocolo de túnel de punto a punto (PPTP) y el protocolo de tunelización de capa 2 (L2TP).

Sintaxis

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;

Miembros

dwIPv4NegotiationError

Valor que especifica el resultado de la negociación del protocolo de control de red IPv4 de PPP. Un valor de cero indica que Ipv4 se ha negociado correctamente. Un valor distinto de cero indica un error y es el error irrecuperable que se produjo durante la negociación del protocolo de control.

wszAddress[IPADDRESSLEN + 1]

Matriz que contiene una cadena Unicode que especifica la dirección IPv4 del cliente local. Esta cadena tiene el formato "a.b.c.d". wszAddress solo es válido si dwIPv4NegotiationError es cero.

wszRemoteAddress[IPADDRESSLEN + 1]

Matriz que contiene una cadena Unicode que especifica la dirección IPv4 del servidor remoto. Esta cadena tiene el formato "a.b.c.d". wszRemoteAddress solo es válido si dwIPv4NegotiationError es cero. Si la dirección no está disponible, este miembro es una cadena vacía.

dwIPv4Options

Valor que especifica las opciones de IPCP para el cliente local.

Valor	Significado
PPP_IPCP_VJ	Indica que los datagramas IP enviados por el cliente local se comprimen mediante la compresión van Jacobson.

dwIPv4RemoteOptions

Valor que especifica las opciones de IPCP para el servidor remoto.

Valor	Significado
PPP_IPCP_VJ	Indica que los datagramas IP enviados por el servidor remoto (es decir, recibidos por el equipo local) se comprimen mediante la compresión Van Jacobson.

IPv4SubInterfaceIndex

Valor que especifica el índice de subinterfase IPv4 correspondiente a la conexión en el servidor.

dwIPv6NegotiationError

Valor que especifica el resultado de la negociación del protocolo de control de red IPv6 de PPP. Un valor de cero indica que Ipv6 se ha negociado correctamente. Un valor distinto de cero indica un error y es el error irrecuperable que se produjo durante la negociación del protocolo de control.

bInterfaceIdentifier[8]

Matriz que especifica el identificador de interfaz IPv6 de 64 bits del cliente. Los últimos 64 bits de una dirección IPv6 de 128 bits se consideran el "identificador de interfaz", que proporciona un alto nivel de unicidad para los 64 bits anteriores. bInterfaceIdentifier solo es válido si dwIPv6NegotiationError es cero y no debe ser cero.

bRemoteInterfaceIdentifier[8]

Matriz que especifica el identificador de interfaz IPv6 de 64 bits del servidor. Los últimos 64 bits de una dirección IPv6 de 128 bits se consideran el "identificador de interfaz", que proporciona un alto nivel de unicidad para los 64 bits anteriores. bInterfaceIdentifier solo es válido si dwIPv6NegotiationError es cero y no debe ser cero.

bPrefix[8]

Valor que especifica el prefijo de dirección IPv6 de la interfaz de cliente.

dwPrefixLength

Valor que especifica la longitud, en bits, de bPrefix.

IPv6SubInterfaceIndex

Valor que especifica el índice de subinterfase IPv6 correspondiente a la conexión en el servidor.

dwLcpError

Valor que especifica el resultado de la negociación de LCP de PPP. Un valor de cero indica que LCP se ha negociado correctamente. Un valor distinto de cero indica un error y es el error irrecuperable que se produjo durante la negociación del protocolo de control.

dwAuthenticationProtocol

Valor que especifica el protocolo de autenticación que se usa para autenticar el cliente local. Este miembro puede ser uno de los siguientes valores.

Valor	Significado
PPP_LCP_PAP	Protocolo de autenticación de contraseña.
PPP_LCP_CHAP	Protocolo de autenticación de protocolo de enlace de desafío.
PPP_LCP_EAP	Protocolo de autenticación extensible.

dwAuthenticationData

Valor que especifica información adicional sobre el protocolo de autenticación especificado por dwAuthenticationProtocol. Este miembro puede ser uno de los siguientes valores:

Valor	Significado
PPP_LCP_CHAP_MD5	MD5 CHAP
PPP_LCP_CHAP_MS	Microsoft CHAP.
PPP_LCP_CHAP_MSV2	Microsoft CHAP versión 2.

dwRemoteAuthenticationProtocol

Valor que especifica el protocolo de autenticación que se usa para autenticar el servidor remoto. dwAuthenticationProtocol y dwRemoteAuthenticationProtocol variarán cuando el marcado de demanda use distintos protocolos de autenticación en el cliente y el servidor. Este miembro puede ser uno de los siguientes valores:

Valor	Significado
PPP_LCP_PAP	Protocolo de autenticación de contraseña.
PPP_LCP_CHAP	Protocolo de autenticación de protocolo de enlace de desafío.
PPP_LCP_EAP	Protocolo de autenticación extensible.

dwRemoteAuthenticationData

Valor que especifica información adicional sobre el protocolo de autenticación especificado por dwRemoteAuthenticationProtocol. dwAuthenticationData y dwRemoteAuthenticationData variarán cuando el marcado de demanda use distintos protocolos de autenticación en el cliente y el servidor. Este miembro puede ser uno de los siguientes valores:

Valor	Significado
PPP_LCP_CHAP_MD5	MD5 CHAP.
PPP_LCP_CHAP_MS	Microsoft CHAP.
PPP_LCP_CHAP_MSV2	Microsoft CHAP versión 2.

dwLcpTerminateReason

Reservado para uso futuro. Debe ser cero.

dwLcpRemoteTerminateReason

Reservado para uso futuro. Debe ser cero.

dwLcpOptions

Valor que especifica información sobre las opciones de LCP que usa el cliente local. Este miembro es una combinación de las marcas siguientes:

Valor	Significado
PPP_LCP_MULTILINK_FRAMING	La conexión usa varios vínculos.
PPP_LCP_PFC	La conexión usa la compresión de campo de protocolo (RFC 1172).
PPP_LCP_ACFC	La conexión usa la compresión de campo de control y dirección (RFC 1172).
PPP_LCP_SSHF	La conexión usa el formato de encabezado de número de secuencia corta (consulte RFC 1990).
PPP_LCP_DES_56	La conexión usa el cifrado DES de 56 bits.
PPP_LCP_3_DES	La conexión usa el cifrado triple DES.
PPP_LCP_AES_128	La conexión usa cifrado AES de 128 bits.
PPP_LCP_AES_256	La conexión usa cifrado AES de 256 bits.

dwLcpRemoteOptions

Valor que especifica información sobre las opciones de LCP que usa el servidor remoto. Este miembro es una combinación de las marcas siguientes:

Valor	Significado
PPP_LCP_MULTILINK_FRAMING	La conexión usa varios vínculos.
PPP_LCP_PFC	La conexión usa la compresión de campo de protocolo (RFC 1172).
PPP_LCP_ACFC	La conexión usa la compresión de campo de control y dirección (RFC 1172).
PPP_LCP_SSHF	La conexión usa el formato de encabezado de número de secuencia corta (consulte RFC 1990).
PPP_LCP_DES_56	La conexión usa el cifrado DES de 56 bits.
PPP_LCP_3_DES	La conexión usa el cifrado triple DES.
PPP_LCP_AES_128	La conexión usa cifrado AES de 128 bits
PPP_LCP_AES_256	La conexión usa cifrado AES de 256 bits.

dwEapTypeId

Valor que especifica el identificador de tipo del Protocolo de autenticación extensible (EAP) usado para autenticar el cliente local. El valor de este miembro solo es válido si dwAuthenticationProtocol es PPP_LCP_EAP.

dwRemoteEapTypeId

Valor que especifica el identificador de tipo del Protocolo de autenticación extensible (EAP) usado para autenticar el servidor remoto. El valor de este miembro solo es válido si dwRemoteAuthenticationProtocol es PPP_LCP_EAP.

dwCcpError

Valor que especifica el resultado de la negociación de la CCP de PPP. Un valor de cero indica que la CCP se ha negociado correctamente. Un valor distinto de cero indica un error y es el error irrecuperable que se produjo durante la negociación del protocolo de control.

dwCompressionAlgorithm

Valor que especifica el algoritmo de compresión utilizado por el cliente local. En la tabla siguiente se muestran los valores posibles para este miembro.

Valor	Significado
RASCCPCA_MPPC	Protocolo de compresión de punto a punto de Microsoft (MPPC) (RFC 2118).
RASCCPCA_STAC	Opción STAC 4 (RFC 1974).

dwCcpOptions

Valor que especifica los tipos de compresión disponibles en el cliente local. Se admiten los siguientes tipos:

Valor	Significado
PPP_CCP_COMPRESSION	Compresión sin cifrado.
PPP_CCP_HISTORYLESS	Cifrado de punto a punto de Microsoft (MPPE) en modo sin estado. La clave de sesión se cambia después de cada paquete. Este modo mejora el rendimiento en redes de alta latencia o redes que experimentan una pérdida significativa de paquetes.
PPP_CCP_ENCRYPTION40BITOLD	Compresión MPPE con claves de 40 bits.
PPP_CCP_ENCRYPTION40BIT	Compresión MPPE con claves de 40 bits.
PPP_CCP_ENCRYPTION56BIT	Compresión MPPE con claves de 56 bits.
PPP_CCP_ENCRYPTION128BIT	Compresión MPPE con claves de 128 bits.

Las tres últimas opciones se usan cuando se realiza una conexión a través del Protocolo de tunelización de capa 2 (L2TP) y la conexión usa el cifrado IPSec.

dwRemoteCompressionAlgorithm

Valor que especifica el algoritmo de compresión utilizado por el servidor remoto. Se admiten los siguientes algoritmos:

Valor	Significado
RASCCPCA_MPPC	Protocolo de compresión de punto a punto de Microsoft (MPPC) ( RFC 2118).
RASCCPCA_STAC	STAC opción 4 ( RFC 1974).

dwCcpRemoteOptions

Valor que especifica los tipos de compresión disponibles en el servidor remoto. Se admiten los siguientes tipos:

Valor	Significado
PPP_CCP_COMPRESSION	Compresión sin cifrado.
PPP_CCP_HISTORYLESS	Cifrado de punto a punto de Microsoft (MPPE) en modo sin estado. La clave de sesión se cambia después de cada paquete. Este modo mejora el rendimiento en redes de alta latencia o redes que experimentan una pérdida significativa de paquetes.
PPP_CCP_ENCRYPTION40BITOLD	Compresión MPPE con claves de 40 bits.
PPP_CCP_ENCRYPTION40BIT	Compresión MPPE con claves de 40 bits.
PPP_CCP_ENCRYPTION56BIT	Compresión MPPE con claves de 56 bits.
PPP_CCP_ENCRYPTION128BIT	Compresión MPPE con claves de 128 bits.
ERROR_PPP_NOT_CONVERGING	El equipo remoto y RRAS no pudieron converger en la negociación de direcciones.

Las tres últimas opciones se usan cuando se realiza una conexión a través del Protocolo de tunelización de capa 2 (L2TP) y la conexión usa el cifrado IPSec.

Requisitos

Requisito	Value
Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Encabezado	mprapi.h

Consulte también

Referencia de administración de enrutadores

Estructuras de administración de enrutadores

Compartir a través de

estructura PPP_PROJECTION_INFO (mprapi.h)

Sintaxis

Miembros

Requisitos

Consulte también

Comentarios

Recursos adicionales