Partager via

structure PPP_PROJECTION_INFO (mprapi.h)

  • Article

La structure PPP_PROJECTION_INFO contient des 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_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;

Membres

dwIPv4NegotiationError

Valeur qui spécifie le résultat de la négociation du protocole de contrôle réseau PPP IPv4. La valeur zéro indique qu’Ipv4 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.

wszAddress[IPADDRESSLEN + 1]

Tableau qui contient une chaîne Unicode qui spécifie l’adresse IPv4 du client local. Cette chaîne a la forme « a.b.c.d ». wszAddress est valide uniquement si dwIPv4NegotiationError est égal à zéro.

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 ». wszRemoteAddress est valide uniquement si 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 », qui fournit un fort niveau d’unicité pour les 64 bits précédents. bInterfaceIdentifier est valide uniquement si dwIPv6NegotiationError est égal à zéro et ne doit pas être égal à zéro.

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 », qui fournit un fort niveau d’unicité pour les 64 bits précédents. bInterfaceIdentifier est valide uniquement si dwIPv6NegotiationError est égal à zéro et ne doit pas être égal à zéro.

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, de 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 est 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 d’authentification par mot de passe.
PPP_LCP_CHAP
 Challenger le protocole d’authentification d’établissement d’une négociation.
PPP_LCP_EAP
 Protocole d’authentification extensible.

dwAuthenticationData

Valeur qui spécifie des informations supplémentaires sur le protocole d’authentification spécifié par 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. dwAuthenticationProtocol et 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 d’authentification par mot de passe.
PPP_LCP_CHAP
 Challenger le protocole d’authentification d’établissement d’une négociation.
PPP_LCP_EAP
 Protocole d’authentification extensible.

dwRemoteAuthenticationData

Valeur qui spécifie des informations supplémentaires sur le protocole d’authentification spécifié par dwRemoteAuthenticationProtocol. dwAuthenticationData et 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
 CHAP MD5.
PPP_LCP_CHAP_MS
 Microsoft CHAP.
PPP_LCP_CHAP_MSV2
 Microsoft CHAP version 2.

dwLcpTerminateReason

Réservé pour un usage futur. Doit être zéro.

dwLcpRemoteTerminateReason

Réservé pour un usage futur. Doit être zéro.

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 (RFC 1172).
PPP_LCP_ACFC
La connexion utilise la compression d’adresse et de champ de contrôle (RFC 1172).
PPP_LCP_SSHF
 La connexion utilise le format d’en-tête de numéro séquentiel court (voir RFC 1990).
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 la liaison multilink.
PPP_LCP_PFC
 La connexion utilise la compression de champ de protocole (RFC 1172).
PPP_LCP_ACFC
La connexion utilise la compression de champ d’adresse et de contrôle (RFC 1172).
PPP_LCP_SSHF
 La connexion utilise le format d’en-tête de numéro séquentiel court (voir RFC 1990).
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 dwAuthenticationProtocol est PPP_LCP_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 dwRemoteAuthenticationProtocol est PPP_LCP_EAP.

dwCcpError

Valeur qui spécifie le résultat de la négociation PPP CCP. La valeur zéro indique que le CCP a été négocié avec succès. Une valeur différente de zéro indique un échec, et est 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-to-Point Compression) (RFC 2118).
RASCCPCA_STAC
 Option STAC 4 (RFC 1974).

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-to-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-to-Point Compression) ( RFC 2118).
RASCCPCA_STAC
 Option STAC 4 ( RFC 1974).

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-to-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 sur 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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
En-tête mprapi.h

Voir aussi

Informations de référence sur la gestion des routeurs

Structures de gestion des routeurs