Share via

structure PPP_PROJECTION_INFO2 (mprapi.h)

  • Article

Contient les informations obtenues lors de la négociation point à point (PPP) pour le protocole SSTP (Secure Socket Tunneling Protocol), le protocole PPTP (Point à Point Tunneling Protocol) et le protocole de tunneling de couche 2 (L2TP).

Syntaxe

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;

Membres

dwIPv4NegotiationError

Valeur qui spécifie le résultat de la négociation du protocole de contrôle réseau PPP IPv4. La valeur 0 indique qu’IPv4 a été négocié avec succès. Une valeur différente de zéro indique l’échec et représente également l’erreur irrécupérable qui s’est produite pendant la négociation du protocole de contrôle.

wszAddress[IPADDRESSLEN + 1]

Chaîne Unicode terminée par null qui spécifie l’adresse IPv4 du client local. Cette chaîne a la forme « a.b.c.d ». Le membre wszAddress est valide uniquement si dwIPv4NegotiationError a la valeur 0.

wszRemoteAddress[IPADDRESSLEN + 1]

Tableau qui contient une chaîne Unicode qui spécifie l’adresse IPv4 du serveur distant. Cette chaîne a la forme « a.b.c.d ». Le membre wszRemoteAddress est valide uniquement si le membre dwIPv4NegotiationError est égal à zéro. Si l’adresse n’est pas disponible, ce membre est une chaîne vide.

dwIPv4Options

Valeur qui spécifie les options IPCP pour le client local.

Valeur Signification
PPP_IPCP_VJ
 Indique que les datagrammes IP envoyés par le client local sont compressés à l’aide de la compression Van Jacobson.

dwIPv4RemoteOptions

Valeur qui spécifie les options IPCP pour le serveur distant.

Valeur Signification
PPP_IPCP_VJ
 Indique que les datagrammes IP envoyés par le serveur distant (c’est-à-dire reçus par l’ordinateur local) sont compressés à l’aide de la compression Van Jacobson.

IPv4SubInterfaceIndex

Valeur qui spécifie l’index de sous-interface IPv4 correspondant à la connexion sur le serveur.

dwIPv6NegotiationError

Valeur qui spécifie le résultat de la négociation du protocole de contrôle réseau PPP IPv6. La valeur zéro indique qu’Ipv6 a été négocié avec succès. Une valeur différente de zéro indique l’échec et est l’erreur irrécupérable qui s’est produite pendant la négociation du protocole de contrôle.

bInterfaceIdentifier[8]

Tableau qui spécifie l’identificateur d’interface IPv6 64 bits du client. Les 64 derniers bits d’une adresse Internet IPv6 128 bits sont considérés comme l’identificateur d’interface, ce qui fournit un fort niveau d’unicité pour les 64 bits précédents. Le membre bInterfaceIdentifier ne doit pas être 0 et n’est valide que si le membre dwIPv6NegotiationError est 0.

bRemoteInterfaceIdentifier[8]

Tableau qui spécifie l’identificateur d’interface IPv6 64 bits du serveur. Les 64 derniers bits d’une adresse Internet IPv6 128 bits sont considérés comme l’identificateur d’interface, ce qui fournit un fort niveau d’unicité pour les 64 bits précédents. Le membre bInterfaceIdentifier ne doit pas être 0 et n’est valide que si le membre dwIPv6NegotiationError est 0.

bPrefix[8]

Valeur qui spécifie le préfixe d’adresse IPv6 de l’interface cliente.

dwPrefixLength

Valeur qui spécifie la longueur, en bits, du membre bPrefix .

IPv6SubInterfaceIndex

Valeur qui spécifie l’index de sous-interface IPv6 correspondant à la connexion sur le serveur.

dwLcpError

Valeur qui spécifie le résultat de la négociation PPP LCP. La valeur zéro indique que LCP a été négocié avec succès. Une valeur différente de zéro indique l’échec et représente l’erreur irrécupérable qui s’est produite pendant la négociation du protocole de contrôle.

dwAuthenticationProtocol

Valeur qui spécifie le protocole d’authentification utilisé pour authentifier le client local. Ce membre peut être l’une des valeurs suivantes.

Valeur Signification
PPP_LCP_PAP
 Protocole PAP (Password Authentication Protocol)
PPP_LCP_CHAP
 Challenge Handshake Authentication Protocol
PPP_LCP_EAP
 Protocole EAP (Extensible Authentication Protocol)

dwAuthenticationData

Valeur qui spécifie des informations supplémentaires sur le protocole d’authentification spécifié par le membre dwAuthenticationProtocol . Ce membre peut être l’une des valeurs suivantes.

Valeur Signification
PPP_LCP_CHAP_MD5
 MD5 CHAP
PPP_LCP_CHAP_MS
 Microsoft CHAP
PPP_LCP_CHAP_MSV2
 Microsoft CHAP version 2

dwRemoteAuthenticationProtocol

Valeur qui spécifie le protocole d’authentification utilisé pour authentifier le serveur distant. Le membre dwAuthenticationProtocol et le membre dwRemoteAuthenticationProtocol diffèrent lorsque la numérotation à la demande utilise des protocoles d’authentification différents sur le client et le serveur. Ce membre peut être l’une des valeurs suivantes.

Valeur Signification
PPP_LCP_PAP
 Protocole PAP (Password Authentication Protocol)
PPP_LCP_CHAP
 Challenge Handshake Authentication Protocol
PPP_LCP_EAP
 Protocole EAP (Extensible Authentication Protocol)

dwRemoteAuthenticationData

Valeur qui spécifie des informations supplémentaires sur le protocole d’authentification spécifié par le membre dwRemoteAuthenticationProtocol . Le membre dwAuthenticationData et le membre dwRemoteAuthenticationData diffèrent lorsque la numérotation à la demande utilise différents protocoles d’authentification sur le client et le serveur. Ce membre peut être l’une des valeurs suivantes.

Valeur Signification
PPP_LCP_CHAP_MD5
 MD5 CHAP
PPP_LCP_CHAP_MS
 Microsoft CHAP
PPP_LCP_CHAP_MSV2
 Microsoft CHAP version 2

dwLcpTerminateReason

Non implémenté. Doit être égal à 0.

dwLcpRemoteTerminateReason

Non implémenté. Doit être égal à 0.

dwLcpOptions

Valeur qui spécifie des informations sur les options LCP utilisées par le client local. Ce membre est une combinaison des indicateurs suivants.

Valeur Signification
PPP_LCP_MULTILINK_FRAMING
 La connexion utilise multilink.
PPP_LCP_PFC
 La connexion utilise la compression de champ de protocole.
PPP_LCP_ACFC
 La connexion utilise la compression d’adresse et de champ de contrôle.
PPP_LCP_SSHF
 La connexion utilise le format d’en-tête de numéro de séquence courte.
PPP_LCP_DES_56
 La connexion utilise le chiffrement DES 56 bits.
PPP_LCP_3_DES
 La connexion utilise le chiffrement Triple DES.
PPP_LCP_AES_128
 La connexion utilise le chiffrement AES 128 bits.
PPP_LCP_AES_256
 La connexion utilise le chiffrement AES 256 bits.

dwLcpRemoteOptions

Valeur qui spécifie des informations sur les options LCP utilisées par le serveur distant. Ce membre est une combinaison des indicateurs suivants.

Valeur Signification
PPP_LCP_MULTILINK_FRAMING
 La connexion utilise multilink.
PPP_LCP_PFC
 La connexion utilise la compression de champ de protocole.
PPP_LCP_ACFC
La connexion utilise la compression d’adresse et de champ de contrôle.
PPP_LCP_SSHF
 La connexion utilise le format d’en-tête de numéro de séquence courte.
PPP_LCP_DES_56
 La connexion utilise le chiffrement DES 56 bits.
PPP_LCP_3_DES
 La connexion utilise le chiffrement Triple DES.
PPP_LCP_AES_128
 La connexion utilise le chiffrement AES 128 bits.
PPP_LCP_AES_256
 La connexion utilise le chiffrement AES 256 bits.

dwEapTypeId

Valeur qui spécifie l’identificateur de type du protocole EAP (Extensible Authentication Protocol) utilisé pour authentifier le client local. La valeur de ce membre est valide uniquement si le membre dwAuthenticationProtocol est PPP_LCP_EAP.

dwEmbeddedEAPTypeId

Valeur qui spécifie l’identificateur de type de la méthode EAP interne utilisée dans l’authentification EAP. La valeur de ce membre est valide uniquement si le membre dwEapTypeId est défini sur PEAP défini dans IANA-EAP.

dwRemoteEapTypeId

Valeur qui spécifie l’identificateur de type du protocole EAP (Extensible Authentication Protocol) utilisé pour authentifier le serveur distant. La valeur de ce membre est valide uniquement si le membre dwRemoteAuthenticationProtocol est PPP_LCP_EAP.

dwCcpError

Valeur qui spécifie le résultat de la négociation PPP CCP. La valeur 0 indique que le CCP a été négocié avec succès. Une valeur différente de zéro indique l’échec et représente l’erreur irrécupérable qui s’est produite pendant la négociation du protocole de contrôle.

dwCompressionAlgorithm

Valeur qui spécifie l’algorithme de compression utilisé par le client local. Le tableau suivant montre les valeurs possibles pour ce membre.

Valeur Signification
RASCCPCA_MPPC
 Protocole MPPC (Microsoft Point à Point Compression).
RASCCPCA_STAC
 Option STAC 4.

dwCcpOptions

Valeur qui spécifie les types de compression disponibles sur le client local. Les types suivants sont pris en charge.

Valeur Signification
PPP_CCP_COMPRESSION
 Compression sans chiffrement.
PPP_CCP_HISTORYLESS
 Microsoft Point à Point Encryption (MPPE) en mode sans état. La clé de session est modifiée après chaque paquet. Ce mode améliore les performances sur les réseaux à latence élevée ou les réseaux qui subissent une perte de paquets importante.
PPP_CCP_ENCRYPTION40BITOLD
 Compression MPPE à l’aide de clés 40 bits.
PPP_CCP_ENCRYPTION40BIT
 Compression MPPE à l’aide de clés 40 bits.
PPP_CCP_ENCRYPTION56BIT
 Compression MPPE à l’aide de clés 56 bits.
PPP_CCP_ENCRYPTION128BIT
 Compression MPPE à l’aide de clés 128 bits.
 

Les trois dernières options sont utilisées lorsqu’une connexion est établie via le protocole L2TP (Layer 2 Tunneling Protocol) et que la connexion utilise le chiffrement IPSec.

dwRemoteCompressionAlgorithm

Valeur qui spécifie l’algorithme de compression utilisé par le serveur distant. Les algorithmes suivants sont pris en charge.

Valeur Signification
RASCCPCA_MPPC
 Protocole MPPC (Microsoft Point à Point Compression).
RASCCPCA_STAC
 Option STAC 4.

dwCcpRemoteOptions

Valeur qui spécifie les types de compression disponibles sur le serveur distant. Les types suivants sont pris en charge.

Valeur Signification
PPP_CCP_COMPRESSION
 Compression sans chiffrement.
PPP_CCP_HISTORYLESS
 Microsoft Point à Point Encryption (MPPE) en mode sans état. La clé de session est modifiée après chaque paquet. Ce mode améliore les performances sur les réseaux à latence élevée ou les réseaux qui subissent une perte de paquets importante.
PPP_CCP_ENCRYPTION40BITOLD
 Compression MPPE à l’aide de clés 40 bits.
PPP_CCP_ENCRYPTION40BIT
 Compression MPPE à l’aide de clés 40 bits.
PPP_CCP_ENCRYPTION56BIT
 Compression MPPE à l’aide de clés 56 bits.
PPP_CCP_ENCRYPTION128BIT
 Compression MPPE à l’aide de clés 128 bits.
ERROR_PPP_NOT_CONVERGING
 L’ordinateur distant et RRAS n’ont pas pu converger vers la négociation d’adresses.
 

Les trois dernières options sont utilisées lorsqu’une connexion est établie via le protocole L2TP (Layer 2 Tunneling Protocol) et que la connexion utilise le chiffrement IPSec.

Spécifications

   
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
En-tête mprapi.h