estrutura PPP_PROJECTION_INFO (mprapi.h)
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 |
---|---|
|
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 |
---|---|
|
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 |
---|---|
|
Protocolo de Autenticação de Senha. |
|
Desafio Protocolo de Autenticação de Handshake. |
|
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 |
---|---|
|
MD5 CHAP |
|
Microsoft CHAP. |
|
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 |
---|---|
|
Protocolo de Autenticação de Senha. |
|
Desafio Protocolo de Autenticação de Handshake. |
|
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 |
---|---|
|
MD5 CHAP. |
|
Microsoft CHAP. |
|
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 |
---|---|
|
A conexão está usando multilink. |
|
A conexão está usando a Compactação de Campo de Protocolo (RFC 1172). |
|
A conexão está usando a Compactação de Campo de Endereço e Controle (RFC 1172). |
|
A conexão está usando o Formato de Cabeçalho de Número de Sequência Curta (consulte RFC 1990). |
|
A conexão está usando a criptografia DES de 56 bits. |
|
A conexão está usando a Criptografia DES Tripla. |
|
A conexão está usando a Criptografia AES de 128 bits. |
|
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 |
---|---|
|
A conexão está usando multilink. |
|
A conexão está usando a Compactação de Campo de Protocolo (RFC 1172). |
|
A conexão está usando a Compactação de Campo de Endereço e Controle (RFC 1172). |
|
A conexão está usando o Formato de Cabeçalho de Número de Sequência Curta (consulte RFC 1990). |
|
A conexão está usando a criptografia DES de 56 bits. |
|
A conexão está usando a Criptografia DES Tripla. |
|
A conexão está usando a Criptografia AES de 128 bits |
|
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 |
---|---|
|
Protocolo MPPC (Compactação Ponto a Ponto) da Microsoft (RFC 2118). |
|
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:
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 |
---|---|
|
Protocolo MPPC (Compactação Ponto a Ponto) da Microsoft ( RFC 2118). |
|
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:
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 |