Compartilhar via


estrutura RASPPP_PROJECTION_INFO (ras.h)

A estrutura de RASPPP_PROJECTION_INFO contém informações obtidas durante a negociação PPP (ponto a ponto) das operações de projeção IPv4 (Protocolo IPv4) e IPv6 e LCP (Protocolo de Controle de Link PPP)/multilink e CCP (Protocolo de Controle de Compactação).

Sintaxe

typedef struct _RASPPP_PROJECTION_INFO {
  DWORD       dwIPv4NegotiationError;
  RASIPV4ADDR ipv4Address;
  RASIPV4ADDR ipv4ServerAddress;
  DWORD       dwIPv4Options;
  DWORD       dwIPv4ServerOptions;
  DWORD       dwIPv6NegotiationError;
  BYTE        bInterfaceIdentifier[8];
  BYTE        bServerInterfaceIdentifier[8];
  BOOL        fBundled;
  BOOL        fMultilink;
  DWORD       dwAuthenticationProtocol;
  DWORD       dwAuthenticationData;
  DWORD       dwServerAuthenticationProtocol;
  DWORD       dwServerAuthenticationData;
  DWORD       dwEapTypeId;
  DWORD       dwServerEapTypeId;
  DWORD       dwLcpOptions;
  DWORD       dwLcpServerOptions;
  DWORD       dwCcpError;
  DWORD       dwCcpCompressionAlgorithm;
  DWORD       dwCcpServerCompressionAlgorithm;
  DWORD       dwCcpOptions;
  DWORD       dwCcpServerOptions;
} RASPPP_PROJECTION_INFO, *PRASPPP_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.

ipv4Address

Um RASIPV4ADDR que contém uma cadeia de caracteres Unicode terminada em nulo que especifica o endereço IPv4 do cliente local. Essa cadeia de caracteres tem o formato "a.b.c.d". ipv4Address só será válido se dwIPv4NegotiationError for zero.

ipv4ServerAddress

Uma estrutura RASIPV4ADDR que contém uma cadeia de caracteres Unicode que especifica o endereço IPv4 do servidor remoto. Essa cadeia de caracteres tem o formato "a.b.c.d". ipv4ServerAddress 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 protocolo IPCP para o cliente local.

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

dwIPv4ServerOptions

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

Valor Significado
RASIPO_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.

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 nível forte de exclusividade para os 64 bits anteriores. bInterfaceIdentifier não deve ser zero e só será válido se dwIPv6NegotiationError for zero.

bServerInterfaceIdentifier[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 nível forte de exclusividade para os 64 bits anteriores. bServerInterfaceIdentifier não deve ser zero e só será válido se dwIPv6NegotiationError for zero.

fBundled

Um BOOL que será TRUE se a conexão for composta por vários links e FALSE caso contrário.

fMultilink

Um BOOL que será TRUE se a conexão der suporte a vários links e FALSE caso contrário.

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
RASLCPAP_PAP
Protocolo de autenticação de senha.
RASLCPAP_SPAP
Protocolo shiva de autenticação de senha.
RASLCPAP_CHAP
Protocolo de autenticação de handshake de desafio.
RASLCPAP_EAP
Protocolo de Autenticação Extensível.

dwAuthenticationData

Um valor que especifica informações adicionais sobre o protocolo de autenticação especificado por dwAuthenticationProtocol. dwAuthenticationData e dwServerAuthenticationData quando diferentes protocolos de autenticação no cliente e no servidor. Esse membro pode ser um dos seguintes valores:

Valor Significado
RASLCPAD_CHAP_MD5
MD5 CHAP.
RASLCPAD_CHAP_MS
Microsoft CHAP.
RASLCPAD_CHAP_MSV2
Microsoft CHAP versão 2.

dwServerAuthenticationProtocol

Um valor que especifica o protocolo de autenticação usado para autenticar o servidor remoto. Esse membro pode ser um dos seguintes valores:

Valor Significado
RASLCPAP_PAP
Protocolo de autenticação de senha.
RASLCPAP_SPAP
Protocolo shiva de autenticação de senha.
RASLCPAP_CHAP
Protocolo de autenticação de handshake de desafio.
RASLCPAP_EAP
Protocolo de Autenticação Extensível.

dwServerAuthenticationData

Um valor que especifica informações adicionais sobre o protocolo de autenticação especificado por dwServerAuthenticationProtocol. dwAuthenticationData e dwServerAuthenticationData quando diferentes protocolos de autenticação no cliente e no servidor. Esse membro pode ser um dos seguintes valores:

Valor Significado
RASLCPAD_CHAP_MD5
MD5 CHAP.
RASLCPAD_CHAP_MS
Microsoft CHAP.
RASLCPAD_CHAP_MSV2
Microsoft CHAP versão 2.

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 RASLCPAPP_EAP..

dwServerEapTypeId

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 RASLCPAPP_EAP..

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
RASLCPO_PFC
A conexão está usando a RFC 1172 (Compactação de Campo de Protocolo).
RASLCPO_ACFC
A conexão está usando a Compactação de Campo de Endereço e Controle (RFC 1172).
RASLCPO_SSHF
A conexão está usando o formato de cabeçalho de número de sequência curta (consulte RFC 1990).
RASLCPO_DES_56
A conexão está usando a criptografia DES de 56 bits.
RASLCPO_3_DES
A conexão está usando a Criptografia DES Tripla.

dwLcpServerOptions

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
RASLCPO_PFC
A conexão está usando a RFC 1172 (Compactação de Campo de Protocolo).
RASLCPO_ACFC
A conexão está usando a Compactação de Campo de Endereço e Controle (RFC 1172).
RASLCPO_SSHF
A conexão está usando o formato de cabeçalho de número de sequência curta (consulte RFC 1990).
RASLCPO_DES_56
A conexão está usando a criptografia DES de 56 bits.
RASLCPO_3_DES
A conexão está usando a Criptografia DES Tripla.

dwCcpError

dwCcpCompressionAlgorithm

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).

dwCcpServerCompressionAlgorithm

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).

dwCcpOptions

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

Valor Significado
RASCCPO_COMPRESSION
Compactação sem criptografia.
RASCCPO_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.
RASCCPO_ENCRYPTION40BITOLD
Compactação MPPE usando chaves de 40 bits.
RASCCPO_ENCRYPTION40BIT
Compactação MPPE usando chaves de 40 bits.
RASCCPO_ENCRYPTION56BIT
Compactação MPPE usando chaves de 56 bits.
RASCCPO_ENCRYPTION128BIT
Compactação MPPE usando chaves de 128 bits.

dwCcpServerOptions

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

Valor Significado
RASCCPO_COMPRESSION
Compactação sem criptografia.
RASCCPO_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.
RASCCPO_ENCRYPTION40BITOLD
Compactação MPPE usando chaves de 40 bits.
RASCCPO_ENCRYPTION40BIT
Compactação MPPE usando chaves de 40 bits.
RASCCPO_ENCRYPTION56BIT
Compactação MPPE usando chaves de 56 bits.
RASCCPO_ENCRYPTION128BIT
Compactação MPPE usando chaves de 128 bits.

Requisitos

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

Confira também

RasGetProjectionInfoEx

Visão geral do RAS (Serviço de Acesso Remoto)

Estruturas de serviço de acesso remoto