structure PPP_PROJECTION_INFO (mprapi.h)

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.

dwIPv4RemoteOptions

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

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.

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 :

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 :

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 :

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 :

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 :

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.

dwCcpOptions

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

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 :

dwCcpRemoteOptions

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

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

Voir aussi

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

Structures de gestion des routeurs