estrutura PPP_PROJECTION_INFO (mprapi.h)

Artigo
03/15/2023

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

Sintaxe

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;

Membros

dwIPv4NegotiationError

Um valor que especifica o resultado da negociação do protocolo de controle de rede PPP IPv4. Um valor zero indica que o Ipv4 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.

wszAddress[IPADDRESSLEN + 1]

Uma matriz que contém uma cadeia de caracteres Unicode que especifica o endereço IPv4 do cliente local. Essa cadeia de caracteres tem o formulário "a.b.c.d". wszAddress só será válido se dwIPv4NegotiationError for zero.

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". wszRemoteAddress só será válido se 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. bInterfaceIdentifier só será válido se dwIPv6NegotiationError for zero e não precisar ser zero.

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. bInterfaceIdentifier só será válido se dwIPv6NegotiationError for zero e não precisar ser zero.

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, de 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 é 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 de Autenticação de Senha.
PPP_LCP_CHAP	Desafio Protocolo de Autenticação de Handshake.
PPP_LCP_EAP	Protocolo de Autenticação Extensível.

dwAuthenticationData

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

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. dwAuthenticationProtocol e 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 seguintes valores:

Valor	Significado
PPP_LCP_PAP	Protocolo de Autenticação de Senha.
PPP_LCP_CHAP	Desafio Protocolo de Autenticação de Handshake.
PPP_LCP_EAP	Protocolo de Autenticação Extensível.

dwRemoteAuthenticationData

Um valor que especifica informações adicionais sobre o protocolo de autenticação especificado por dwRemoteAuthenticationProtocol. dwAuthenticationData e 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 seguintes valores:

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

dwLcpTerminateReason

Reservado para uso futuro. Deve ser zero.

dwLcpRemoteTerminateReason

Reservado para uso futuro. Deve ser zero.

dwLcpOptions

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

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 (RFC 1172).
PPP_LCP_ACFC	A conexão está usando a Compactação de Campo de Endereço e Controle (RFC 1172).
PPP_LCP_SSHF	A conexão está usando o Formato de Cabeçalho de Número de Sequência Curta (consulte RFC 1990).
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 seguintes sinalizadores:

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 (RFC 1172).
PPP_LCP_ACFC	A conexão está usando a Compactação de Campo de Endereço e Controle (RFC 1172).
PPP_LCP_SSHF	A conexão está usando o Formato de Cabeçalho de Número de Sequência Curta (consulte RFC 1990).
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 dwAuthenticationProtocol for PPP_LCP_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 será válido somente se dwRemoteAuthenticationProtocol for PPP_LCP_EAP.

dwCcpError

Um valor que especifica o resultado da negociação do PPP CCP. Um valor igual a zero indica que o CCP 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.

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 (RFC 2118).
RASCCPCA_STAC	Opção STAC 4 (RFC 1974).

dwCcpOptions

Um valor que especifica os tipos de compactação disponíveis no cliente local. Os seguintes tipos têm suporte:

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 seguintes algoritmos:

Valor	Significado
RASCCPCA_MPPC	Protocolo MPPC (Compactação Ponto a Ponto) da Microsoft ( RFC 2118).
RASCCPCA_STAC	Opção STAC 4 ( RFC 1974).

dwCcpRemoteOptions

Um valor que especifica os tipos de compactação disponíveis no servidor remoto. Os seguintes tipos têm suporte:

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

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

Confira também

Referência de gerenciamento de roteador

Estruturas de gerenciamento de roteador

Compartilhar via

estrutura PPP_PROJECTION_INFO (mprapi.h)

Sintaxe

Membros

Requisitos

Confira também

Comentários

Recursos adicionais