estrutura PPP_PROJECTION_INFO2 (mprapi.h)

Artigo
08/24/2023

Contém informações obtidas durante a negociação ponto a ponto (PPP) para Protocolo de Túnel de Soquete Seguro (SSTP), PPTP (Protocolo de Túnel Ponto a Ponto) e Protocolo de Túnel de Camada 2 (L2TP).

Sintaxe

typedef struct _PPP_PROJECTION_INFO2 {
  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   dwEmbeddedEAPTypeId;
  DWORD   dwRemoteEapTypeId;
  DWORD   dwCcpError;
  DWORD   dwCompressionAlgorithm;
  DWORD   dwCcpOptions;
  DWORD   dwRemoteCompressionAlgorithm;
  DWORD   dwCcpRemoteOptions;
} PPP_PROJECTION_INFO2, *PPPP_PROJECTION_INFO2;

Membros

dwIPv4NegotiationError

Um valor que especifica o resultado da negociação do protocolo de controle de rede PPP IPv4. Um valor 0 indica que o IPv4 foi negociado com êxito. Um valor diferente de zero indica falha e também representa o erro fatal que ocorreu durante a negociação do protocolo de controle.

wszAddress[IPADDRESSLEN + 1]

Uma cadeia de caracteres Unicode terminada em nulo que especifica o endereço IPv4 do cliente local. Essa cadeia de caracteres tem o formulário "a.b.c.d". O membro wszAddress só será válido se dwIPv4NegotiationError for 0.

wszRemoteAddress[IPADDRESSLEN + 1]

Uma matriz que contém uma cadeia de caracteres Unicode que especifica o endereço IPv4 do servidor remoto. Essa cadeia de caracteres tem o formulário "a.b.c.d". O membro wszRemoteAddress só será válido se o membro dwIPv4NegotiationError for zero. Se o endereço não estiver disponível, esse membro será uma cadeia de caracteres vazia.

dwIPv4Options

Um valor que especifica as opções de IPCP para o cliente local.

Valor	Significado
PPP_IPCP_VJ	Indica que os datagramas de IP enviados pelo cliente local são compactados usando a compactação Van Jacobson.

dwIPv4RemoteOptions

Um valor que especifica as opções de IPCP para o servidor remoto.

Valor	Significado
PPP_IPCP_VJ	Indica que os datagramas de IP enviados pelo servidor remoto (ou seja, recebidos pelo computador local) são compactados usando a compactação Van Jacobson.

IPv4SubInterfaceIndex

Um valor que especifica o índice de subinterface IPv4 correspondente à conexão no servidor.

dwIPv6NegotiationError

Um valor que especifica o resultado da negociação do protocolo de controle de rede PPP IPv6. Um valor zero indica que o Ipv6 foi negociado com êxito. Um valor diferente de zero indica falha e é o erro fatal que ocorreu durante a negociação do protocolo de controle.

bInterfaceIdentifier[8]

Uma matriz que especifica o identificador de interface IPv6 de 64 bits do cliente. Os últimos 64 bits de um endereço de Internet IPv6 de 128 bits são considerados o identificador de interface, que fornece um forte nível de exclusividade para os 64 bits anteriores. O membro bInterfaceIdentifier não deve ser 0 e é válido somente se o membro dwIPv6NegotiationError for 0.

bRemoteInterfaceIdentifier[8]

Uma matriz que especifica o identificador de interface IPv6 de 64 bits do servidor. Os últimos 64 bits de um endereço de Internet IPv6 de 128 bits são considerados o identificador de interface, que fornece um forte nível de exclusividade para os 64 bits anteriores. O membro bInterfaceIdentifier não deve ser 0 e é válido somente se o membro dwIPv6NegotiationError for 0.

bPrefix[8]

Um valor que especifica o prefixo de endereço IPv6 da interface do cliente.

dwPrefixLength

Um valor que especifica o comprimento, em bits, do membro bPrefix .

IPv6SubInterfaceIndex

Um valor que especifica o índice de subinterface IPv6 correspondente à conexão no servidor.

dwLcpError

Um valor que especifica o resultado da negociação PPP LCP. Um valor zero indica que o LCP foi negociado com êxito. Um valor diferente de zero indica falha e representa o erro fatal que ocorreu durante a negociação do protocolo de controle.

dwAuthenticationProtocol

Um valor que especifica o protocolo de autenticação usado para autenticar o cliente local. Esse membro pode ser um dos valores a seguir.

Valor	Significado
PPP_LCP_PAP	Protocolo PAP
PPP_LCP_CHAP	Protocolo de Autenticação de Handshake do Desafio
PPP_LCP_EAP	Protocolo EAP (Extensible Authentication Protocol)

dwAuthenticationData

Um valor que especifica informações adicionais sobre o protocolo de autenticação especificado pelo membro dwAuthenticationProtocol . Esse membro pode ser um dos valores a seguir.

Valor	Significado
PPP_LCP_CHAP_MD5	MD5 CHAP
PPP_LCP_CHAP_MS	Microsoft CHAP
PPP_LCP_CHAP_MSV2	Microsoft CHAP versão 2

dwRemoteAuthenticationProtocol

Um valor que especifica o protocolo de autenticação usado para autenticar o servidor remoto. O membro dwAuthenticationProtocol e o membro dwRemoteAuthenticationProtocol serão diferentes quando a discagem de demanda usar protocolos de autenticação diferentes no cliente e no servidor. Esse membro pode ser um dos valores a seguir.

Valor	Significado
PPP_LCP_PAP	Protocolo PAP
PPP_LCP_CHAP	Protocolo de Autenticação de Handshake do Desafio
PPP_LCP_EAP	Protocolo EAP (Extensible Authentication Protocol)

dwRemoteAuthenticationData

Um valor que especifica informações adicionais sobre o protocolo de autenticação especificado pelo membro dwRemoteAuthenticationProtocol . O membro dwAuthenticationData e o membro dwRemoteAuthenticationData serão diferentes quando a discagem de demanda usar protocolos de autenticação diferentes no cliente e no servidor. Esse membro pode ser um dos valores a seguir.

Valor	Significado
PPP_LCP_CHAP_MD5	MD5 CHAP
PPP_LCP_CHAP_MS	Microsoft CHAP
PPP_LCP_CHAP_MSV2	Microsoft CHAP versão 2

dwLcpTerminateReason

Não implementado. Deve ser 0.

dwLcpRemoteTerminateReason

Não implementado. Deve ser 0.

dwLcpOptions

Um valor que especifica informações sobre as opções de LCP em uso pelo cliente local. Esse membro é uma combinação dos sinalizadores a seguir.

Valor	Significado
PPP_LCP_MULTILINK_FRAMING	A conexão está usando multilink.
PPP_LCP_PFC	A conexão está usando a Compactação de Campo de Protocolo.
PPP_LCP_ACFC	A conexão está usando a Compactação de Campo de Endereço e Controle.
PPP_LCP_SSHF	A conexão está usando o Formato de Cabeçalho de Número de Sequência Curta.
PPP_LCP_DES_56	A conexão está usando a criptografia DES de 56 bits.
PPP_LCP_3_DES	A conexão está usando a Criptografia DES Tripla.
PPP_LCP_AES_128	A conexão está usando a Criptografia AES de 128 bits.
PPP_LCP_AES_256	A conexão está usando a Criptografia AES de 256 bits.

dwLcpRemoteOptions

Um valor que especifica informações sobre as opções de LCP em uso pelo servidor remoto. Esse membro é uma combinação dos sinalizadores a seguir.

Valor	Significado
PPP_LCP_MULTILINK_FRAMING	A conexão está usando multilink.
PPP_LCP_PFC	A conexão está usando a Compactação de Campo de Protocolo.
PPP_LCP_ACFC	A conexão está usando a Compactação de Campo de Endereço e Controle.
PPP_LCP_SSHF	A conexão está usando o Formato de Cabeçalho de Número de Sequência Curta.
PPP_LCP_DES_56	A conexão está usando a criptografia DES de 56 bits.
PPP_LCP_3_DES	A conexão está usando a Criptografia DES Tripla.
PPP_LCP_AES_128	A conexão está usando a Criptografia AES de 128 bits.
PPP_LCP_AES_256	A conexão está usando a Criptografia AES de 256 bits.

dwEapTypeId

Um valor que especifica o identificador de tipo do Protocolo de Autenticação Extensível (EAP) usado para autenticar o cliente local. O valor desse membro será válido somente se o membro dwAuthenticationProtocol for PPP_LCP_EAP.

dwEmbeddedEAPTypeId

Um valor que especifica o identificador de tipo do método EAP interno usado na autenticação EAP. O valor desse membro será válido somente se o membro dwEapTypeId estiver definido como PEAP definido em IANA-EAP.

dwRemoteEapTypeId

Um valor que especifica o identificador de tipo do Protocolo de Autenticação Extensível (EAP) usado para autenticar o servidor remoto. O valor desse membro só será válido se o membro dwRemoteAuthenticationProtocol for PPP_LCP_EAP.

dwCcpError

Um valor que especifica o resultado da negociação do PPP CCP. Um valor 0 indica que o CCP foi negociado com êxito. Um valor diferente de zero indica falha e representa o erro fatal que ocorreu durante a negociação do protocolo de controle.

dwCompressionAlgorithm

Um valor que especifica o algoritmo de compactação usado pelo cliente local. A tabela a seguir mostra os valores possíveis para esse membro.

Valor	Significado
RASCCPCA_MPPC	Protocolo MPPC (compactação ponto a ponto) da Microsoft.
RASCCPCA_STAC	Opção STAC 4.

dwCcpOptions

Um valor que especifica os tipos de compactação disponíveis no cliente local. Há suporte para os tipos a seguir.

Valor	Significado
PPP_CCP_COMPRESSION	Compactação sem criptografia.
PPP_CCP_HISTORYLESS	MPPE (Criptografia Ponto a Ponto) da Microsoft no modo sem estado. A chave de sessão é alterada após cada pacote. Esse modo melhora o desempenho em redes de alta latência ou redes que experimentam perda significativa de pacotes.
PPP_CCP_ENCRYPTION40BITOLD	Compactação MPPE usando chaves de 40 bits.
PPP_CCP_ENCRYPTION40BIT	Compactação MPPE usando chaves de 40 bits.
PPP_CCP_ENCRYPTION56BIT	Compactação MPPE usando chaves de 56 bits.
PPP_CCP_ENCRYPTION128BIT	Compactação MPPE usando chaves de 128 bits.

As últimas três opções são usadas quando uma conexão é feita pelo Protocolo de Túnel de Camada 2 (L2TP) e a conexão usa criptografia IPSec.

dwRemoteCompressionAlgorithm

Um valor que especifica o algoritmo de compactação usado pelo servidor remoto. Há suporte para os algoritmos a seguir.

Valor	Significado
RASCCPCA_MPPC	Protocolo MPPC (compactação ponto a ponto) da Microsoft.
RASCCPCA_STAC	Opção STAC 4.

dwCcpRemoteOptions

Um valor que especifica os tipos de compactação disponíveis no servidor remoto. Há suporte para os tipos a seguir.

Valor	Significado
PPP_CCP_COMPRESSION	Compactação sem criptografia.
PPP_CCP_HISTORYLESS	MPPE (Criptografia Ponto a Ponto) da Microsoft no modo sem estado. A chave de sessão é alterada após cada pacote. Esse modo melhora o desempenho em redes de alta latência ou redes que experimentam perda significativa de pacotes.
PPP_CCP_ENCRYPTION40BITOLD	Compactação MPPE usando chaves de 40 bits.
PPP_CCP_ENCRYPTION40BIT	Compactação MPPE usando chaves de 40 bits.
PPP_CCP_ENCRYPTION56BIT	Compactação MPPE usando chaves de 56 bits.
PPP_CCP_ENCRYPTION128BIT	Compactação MPPE usando chaves de 128 bits.
ERROR_PPP_NOT_CONVERGING	O computador remoto e o RRAS não puderam convergir na negociação de endereços.

As últimas três opções são usadas quando uma conexão é feita pelo Protocolo de Túnel de Camada 2 (L2TP) e a conexão usa criptografia IPSec.

Requisitos


Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2012 [somente aplicativos da área de trabalho]
Cabeçalho	mprapi.h

Compartilhar via

estrutura PPP_PROJECTION_INFO2 (mprapi.h)

Sintaxe

Membros

Requisitos

Comentários

Recursos adicionais