Partager via

structure RASPPP_PROJECTION_INFO (ras.h)

  • Article

La structure RASPPP_PROJECTION_INFO contient des informations obtenues lors de la négociation point à point (PPP) des opérations de projection IPv4 (Internet Protocol version 4) et IPv6, et de la négociation ppp Link Control Protocol (LCP)/multilink et du protocole CCP (Compression Control Protocol).

Syntaxe

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;

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.

ipv4Address

Une RASIPV4ADDR qui contient une 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 ». ipv4Address est valide uniquement si dwIPv4NegotiationError est égal à zéro.

ipv4ServerAddress

Une structure RASIPV4ADDR 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 ». ipv4ServerAddress 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 (Internet Protocol Control Protocol) pour le client local.

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

dwIPv4ServerOptions

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

Valeur Signification
RASIPO_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.

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 ne doit pas être égal à zéro et n’est valide que si dwIPv6NegotiationError est égal à zéro.

bServerInterfaceIdentifier[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. bServerInterfaceIdentifier ne doit pas être égal à zéro et n’est valide que si dwIPv6NegotiationError est égal à zéro.

fBundled

BoOL qui a la valeur TRUE si la connexion est composée de plusieurs liens et FALSE dans le cas contraire.

fMultilink

BoOL qui a la valeur TRUE si la connexion prend en charge plusieurs liens et FALSE dans le cas contraire.

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
RASLCPAP_PAP
 Protocole d’authentification par mot de passe.
RASLCPAP_SPAP
 Protocole d’authentification par mot de passe de Shiva.
RASLCPAP_CHAP
 Challenger le protocole d’authentification d’établissement d’une négociation.
RASLCPAP_EAP
 Protocole d’authentification extensible.

dwAuthenticationData

Valeur qui spécifie des informations supplémentaires sur le protocole d’authentification spécifié par dwAuthenticationProtocol. dwAuthenticationData et dwServerAuthenticationData lorsque différents protocoles d’authentification sur le client et le serveur. Ce membre peut être l’une des valeurs suivantes :

Valeur Signification
RASLCPAD_CHAP_MD5
 CHAP MD5.
RASLCPAD_CHAP_MS
 Microsoft CHAP.
RASLCPAD_CHAP_MSV2
 Microsoft CHAP version 2.

dwServerAuthenticationProtocol

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

Valeur Signification
RASLCPAP_PAP
 Protocole d’authentification par mot de passe.
RASLCPAP_SPAP
 Protocole d’authentification par mot de passe de Shiva.
RASLCPAP_CHAP
 Challenger le protocole d’authentification d’établissement d’une négociation.
RASLCPAP_EAP
 Protocole d’authentification extensible.

dwServerAuthenticationData

Valeur qui spécifie des informations supplémentaires sur le protocole d’authentification spécifié par dwServerAuthenticationProtocol. dwAuthenticationData et dwServerAuthenticationData lorsque différents protocoles d’authentification sur le client et le serveur. Ce membre peut être l’une des valeurs suivantes :

Valeur Signification
RASLCPAD_CHAP_MD5
 CHAP MD5.
RASLCPAD_CHAP_MS
 Microsoft CHAP.
RASLCPAD_CHAP_MSV2
 Microsoft CHAP version 2.

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

dwServerEapTypeId

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

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
RASLCPO_PFC
 La connexion utilise la compression de champ de protocole (RFC 1172).
RASLCPO_ACFC
 La connexion utilise la compression d’adresse et de champ de contrôle (RFC 1172).
RASLCPO_SSHF
 La connexion utilise le format d’en-tête de numéro de séquence courte (voir RFC 1990).
RASLCPO_DES_56
 La connexion utilise le chiffrement DES 56 bits.
RASLCPO_3_DES
 La connexion utilise le chiffrement Triple DES.

dwLcpServerOptions

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
RASLCPO_PFC
 La connexion utilise la compression de champ de protocole (RFC 1172).
RASLCPO_ACFC
 La connexion utilise la compression de champ d’adresse et de contrôle (RFC 1172).
RASLCPO_SSHF
 La connexion utilise le format d’en-tête de numéro séquentiel court (voir RFC 1990).
RASLCPO_DES_56
 La connexion utilise le chiffrement DES 56 bits.
RASLCPO_3_DES
 La connexion utilise le chiffrement Triple DES.

dwCcpError

dwCcpCompressionAlgorithm

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

dwCcpServerCompressionAlgorithm

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

dwCcpOptions

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

Valeur Signification
RASCCPO_COMPRESSION
 Compression sans chiffrement.
RASCCPO_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.
RASCCPO_ENCRYPTION40BITOLD
 Compression MPPE à l’aide de clés 40 bits.
RASCCPO_ENCRYPTION40BIT
 Compression MPPE à l’aide de clés 40 bits.
RASCCPO_ENCRYPTION56BIT
 Compression MPPE à l’aide de clés 56 bits.
RASCCPO_ENCRYPTION128BIT
 Compression MPPE à l’aide de clés 128 bits.

dwCcpServerOptions

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

Valeur Signification
RASCCPO_COMPRESSION
 Compression sans chiffrement.
RASCCPO_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.
RASCCPO_ENCRYPTION40BITOLD
 Compression MPPE à l’aide de clés 40 bits.
RASCCPO_ENCRYPTION40BIT
 Compression MPPE à l’aide de clés 40 bits.
RASCCPO_ENCRYPTION56BIT
 Compression MPPE à l’aide de clés 56 bits.
RASCCPO_ENCRYPTION128BIT
 Compression MPPE à l’aide de clés 128 bits.

Configuration requise

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

Voir aussi

RasGetProjectionInfoEx

Vue d’ensemble du service d’accès à distance (RAS)

Structures du service d’accès à distance