PPP_PROJECTION_INFO-Struktur (mprapi.h)

  • Artikel

Die PPP_PROJECTION_INFO-Struktur enthält Informationen, die während der Ppp-Aushandlung (Point-to-Point) für Secure Socket Tunneling Protocol (SSTP), Point-to-Point Tunneling Protocol (PPTP) und Layer 2 Tunneling Protocol (L2TP) abgerufen wurden.

Syntax

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;

Member

dwIPv4NegotiationError

Ein Wert, der das Ergebnis der PPP-IPv4-Netzwerksteuerungsprotokollaushandlung angibt. Der Wert 0 gibt an, dass Ipv4 erfolgreich ausgehandelt wurde. Ein wert nonzero gibt einen Fehler an und ist der schwerwiegende Fehler, der während der Aushandlung des Kontrollprotokolls aufgetreten ist.

wszAddress[IPADDRESSLEN + 1]

Ein Array, das eine Unicode-Zeichenfolge enthält, die die IPv4-Adresse des lokalen Clients angibt. Diese Zeichenfolge hat das Format "a.b.c.d". wszAddress ist nur gültig, wenn dwIPv4NegotiationError null ist.

wszRemoteAddress[IPADDRESSLEN + 1]

Ein Array, das eine Unicode-Zeichenfolge enthält, die die IPv4-Adresse des Remoteservers angibt. Diese Zeichenfolge hat das Format "a.b.c.d". wszRemoteAddress ist nur gültig, wenn dwIPv4NegotiationError null ist. Wenn die Adresse nicht verfügbar ist, ist dieses Element eine leere Zeichenfolge.

dwIPv4Options

Ein Wert, der IPCP-Optionen für den lokalen Client angibt.

Wert Bedeutung
PPP_IPCP_VJ
 Gibt an, dass IP-Datagramme, die vom lokalen Client gesendet werden, mithilfe der Van Jacobson-Komprimierung komprimiert werden.

dwIPv4RemoteOptions

Ein Wert, der IPCP-Optionen für den Remoteserver angibt.

Wert Bedeutung
PPP_IPCP_VJ
 Gibt an, dass vom Remoteserver gesendete IP-Datagramme (d. h. vom lokalen Computer empfangen) mithilfe der Van Jacobson-Komprimierung komprimiert werden.

IPv4SubInterfaceIndex

Ein Wert, der den Index der IPv4-Unteroberfläche angibt, der der Verbindung auf dem Server entspricht.

dwIPv6NegotiationError

Ein Wert, der das Ergebnis der PPP-IPv6-Netzwerksteuerungsprotokollaushandlung angibt. Der Wert 0 gibt an, dass Ipv6 erfolgreich ausgehandelt wurde. Ein wert nonzero gibt einen Fehler an und ist der schwerwiegende Fehler, der während der Aushandlung des Kontrollprotokolls aufgetreten ist.

bInterfaceIdentifier[8]

Ein Array, das den 64-Bit-IPv6-Schnittstellenbezeichner des Clients angibt. Die letzten 64 Bit einer 128-Bit-IPv6-Internetadresse werden als "Schnittstellenbezeichner" betrachtet, was eine starke Eindeutigkeit für die vorherigen 64-Bits bietet. bInterfaceIdentifier ist nur gültig, wenn dwIPv6NegotiationError null ist und nicht 0 sein darf.

bRemoteInterfaceIdentifier[8]

Ein Array, das den 64-Bit-IPv6-Schnittstellenbezeichner des Servers angibt. Die letzten 64 Bit einer 128-Bit-IPv6-Internetadresse werden als "Schnittstellenbezeichner" betrachtet, was eine starke Eindeutigkeit für die vorherigen 64-Bits bietet. bInterfaceIdentifier ist nur gültig, wenn dwIPv6NegotiationError null ist und nicht 0 sein darf.

bPrefix[8]

Ein Wert, der das IPv6-Adresspräfix der Clientschnittstelle angibt.

dwPrefixLength

Ein Wert, der die Länge von bPrefix in Bits angibt.

IPv6SubInterfaceIndex

Ein Wert, der den Index der IPv6-Unteroberfläche angibt, der der Verbindung auf dem Server entspricht.

dwLcpError

Ein Wert, der das Ergebnis der PPP-LCP-Aushandlung angibt. Der Wert 0 gibt an, dass LCP erfolgreich ausgehandelt wurde. Ein wert nonzero gibt einen Fehler an und ist der schwerwiegende Fehler, der während der Aushandlung des Kontrollprotokolls aufgetreten ist.

dwAuthenticationProtocol

Ein Wert, der das Authentifizierungsprotokoll angibt, das zum Authentifizieren des lokalen Clients verwendet wird. Dieser Member kann einer der folgenden Werte sein.

Wert Bedeutung
PPP_LCP_PAP
 Kennwortauthentifizierungsprotokoll.
PPP_LCP_CHAP
 Challenge-Handshake-Authentifizierungsprotokoll.
PPP_LCP_EAP
 Erweiterbares Authentifizierungsprotokoll.

dwAuthenticationData

Ein Wert, der zusätzliche Informationen zum Authentifizierungsprotokoll angibt, das von dwAuthenticationProtocol angegeben wird. Dieser Member kann einer der folgenden Werte sein:

Wert Bedeutung
PPP_LCP_CHAP_MD5
 MD5 CHAP
PPP_LCP_CHAP_MS
 Microsoft CHAP.
PPP_LCP_CHAP_MSV2
 Microsoft CHAP, Version 2.

dwRemoteAuthenticationProtocol

Ein Wert, der das Authentifizierungsprotokoll angibt, das zum Authentifizieren des Remoteservers verwendet wird. dwAuthenticationProtocol und dwRemoteAuthenticationProtocol unterscheiden sich, wenn die Bedarfswahl unterschiedliche Authentifizierungsprotokolle auf dem Client und Server verwendet. Dieser Member kann einer der folgenden Werte sein:

Wert Bedeutung
PPP_LCP_PAP
 Kennwortauthentifizierungsprotokoll.
PPP_LCP_CHAP
 Challenge-Handshake-Authentifizierungsprotokoll.
PPP_LCP_EAP
 Erweiterbares Authentifizierungsprotokoll.

dwRemoteAuthenticationData

Ein Wert, der zusätzliche Informationen zum Authentifizierungsprotokoll angibt, das von dwRemoteAuthenticationProtocol angegeben wird. dwAuthenticationData und dwRemoteAuthenticationData unterscheiden sich, wenn bei Bedarfswahl verschiedene Authentifizierungsprotokolle auf dem Client und Server verwendet werden. Dieser Member kann einer der folgenden Werte sein:

Wert Bedeutung
PPP_LCP_CHAP_MD5
 MD5 CHAP.
PPP_LCP_CHAP_MS
 Microsoft CHAP.
PPP_LCP_CHAP_MSV2
 Microsoft CHAP, Version 2.

dwLcpTerminateReason

Für die zukünftige Verwendung reserviert. Muss Null sein.

dwLcpRemoteTerminateReason

Für die zukünftige Verwendung reserviert. Muss Null sein.

dwLcpOptions

Ein Wert, der Informationen zu LCP-Optionen angibt, die vom lokalen Client verwendet werden. Dieses Element ist eine Kombination der folgenden Flags:

Wert Bedeutung
PPP_LCP_MULTILINK_FRAMING
 Die Verbindung verwendet Multilink.
PPP_LCP_PFC
 Die Verbindung verwendet Protokollfeldkomprimierung (RFC 1172).
PPP_LCP_ACFC
Die Verbindung verwendet die Adress- und Steuerfeldkomprimierung (RFC 1172).
PPP_LCP_SSHF
 Die Verbindung verwendet das Headerformat für kurze Sequenznummern (siehe RFC 1990).
PPP_LCP_DES_56
 Die Verbindung verwendet die DES-56-Bit-Verschlüsselung.
PPP_LCP_3_DES
 Die Verbindung verwendet Triple DES Encryption.
PPP_LCP_AES_128
 Die Verbindung verwendet die 128-Bit-AES-Verschlüsselung.
PPP_LCP_AES_256
 Die Verbindung verwendet die 256-Bit-AES-Verschlüsselung.

dwLcpRemoteOptions

Ein -Wert, der Informationen zu LCP-Optionen angibt, die vom Remoteserver verwendet werden. Dieser Member ist eine Kombination der folgenden Flags:

Wert Bedeutung
PPP_LCP_MULTILINK_FRAMING
 Die Verbindung verwendet Multilink.
PPP_LCP_PFC
 Die Verbindung verwendet die Protokollfeldkomprimierung (RFC 1172).
PPP_LCP_ACFC
Die Verbindung verwendet die Adress- und Steuerfeldkomprimierung (RFC 1172).
PPP_LCP_SSHF
 Die Verbindung verwendet das Headerformat für kurze Sequenznummern (siehe RFC 1990).
PPP_LCP_DES_56
 Die Verbindung verwendet die DES-56-Bit-Verschlüsselung.
PPP_LCP_3_DES
 Die Verbindung verwendet Triple DES Encryption.
PPP_LCP_AES_128
 Die Verbindung verwendet die 128-Bit-AES-Verschlüsselung.
PPP_LCP_AES_256
 Die Verbindung verwendet die 256-Bit-AES-Verschlüsselung.

dwEapTypeId

Ein -Wert, der den Typbezeichner des Extensible Authentication Protocol (EAP) angibt, das zum Authentifizieren des lokalen Clients verwendet wird. Der Wert dieses Members ist nur gültig, wenn dwAuthenticationProtocolPPP_LCP_EAP ist.

dwRemoteEapTypeId

Ein -Wert, der den Typbezeichner des Extensible Authentication Protocol (EAP) angibt, das zum Authentifizieren des Remoteservers verwendet wird. Der Wert dieses Members ist nur gültig, wenn dwRemoteAuthenticationProtocolPPP_LCP_EAP ist.

dwCcpError

Ein -Wert, der das Ergebnis der PPP CCP-Aushandlung angibt. Der Wert 0 (null) gibt an, dass CCP erfolgreich ausgehandelt wurde. Ein Wert ungleich null gibt einen Fehler an und ist der schwerwiegende Fehler, der während der Aushandlung des Kontrollprotokolls aufgetreten ist.

dwCompressionAlgorithm

Ein -Wert, der den vom lokalen Client verwendeten Komprimierungsalgorithmus angibt. Die folgende Tabelle zeigt die möglichen Werte für diesen Member.

Wert Bedeutung
RASCCPCA_MPPC
 Microsoft Point-to-Point Compression (MPPC)-Protokoll (RFC 2118).
RASCCPCA_STAC
 STAC-Option 4 (RFC 1974).

dwCcpOptions

Ein -Wert, der die auf dem lokalen Client verfügbaren Komprimierungstypen angibt. Die folgenden Typen werden unterstützt:

Wert Bedeutung
PPP_CCP_COMPRESSION
 Komprimierung ohne Verschlüsselung.
PPP_CCP_HISTORYLESS
 Microsoft Point-to-Point-Verschlüsselung (MPPE) im zustandslosen Modus. Der Sitzungsschlüssel wird nach jedem Paket geändert. Dieser Modus verbessert die Leistung in Netzwerken mit hoher Latenz oder In Netzwerken, in denen erhebliche Paketverluste auftreten.
PPP_CCP_ENCRYPTION40BITOLD
 MPPE-Komprimierung mit 40-Bit-Schlüsseln.
PPP_CCP_ENCRYPTION40BIT
 MPPE-Komprimierung mit 40-Bit-Schlüsseln.
PPP_CCP_ENCRYPTION56BIT
 MPPE-Komprimierung mit 56-Bit-Schlüsseln.
PPP_CCP_ENCRYPTION128BIT
 MPPE-Komprimierung mit 128-Bit-Schlüsseln.
 

Die letzten drei Optionen werden verwendet, wenn eine Verbindung über Layer 2 Tunneling Protocol (L2TP) hergestellt wird und die Verbindung ipSec-Verschlüsselung verwendet.

dwRemoteCompressionAlgorithm

Ein -Wert, der den vom Remoteserver verwendeten Komprimierungsalgorithmus angibt. Die folgenden Algorithmen werden unterstützt:

Wert Bedeutung
RASCCPCA_MPPC
 Microsoft Point-to-Point-Komprimierungsprotokoll (MPPC) ( RFC 2118).
RASCCPCA_STAC
 STAC-Option 4 ( RFC 1974).

dwCcpRemoteOptions

Ein -Wert, der die auf dem Remoteserver verfügbaren Komprimierungstypen angibt. Die folgenden Typen werden unterstützt:

Wert Bedeutung
PPP_CCP_COMPRESSION
 Komprimierung ohne Verschlüsselung.
PPP_CCP_HISTORYLESS
 Microsoft Point-to-Point-Verschlüsselung (MPPE) im zustandslosen Modus. Der Sitzungsschlüssel wird nach jedem Paket geändert. Dieser Modus verbessert die Leistung in Netzwerken mit hoher Latenz oder In Netzwerken, in denen erhebliche Paketverluste auftreten.
PPP_CCP_ENCRYPTION40BITOLD
 MPPE-Komprimierung mit 40-Bit-Schlüsseln.
PPP_CCP_ENCRYPTION40BIT
 MPPE-Komprimierung mit 40-Bit-Schlüsseln.
PPP_CCP_ENCRYPTION56BIT
 MPPE-Komprimierung mit 56-Bit-Schlüsseln.
PPP_CCP_ENCRYPTION128BIT
 MPPE-Komprimierung mit 128-Bit-Schlüsseln.
ERROR_PPP_NOT_CONVERGING
 Der Remotecomputer und RRAS konnten bei der Adressaushandlung nicht zusammengeführt werden.
 

Die letzten drei Optionen werden verwendet, wenn eine Verbindung über Layer 2 Tunneling Protocol (L2TP) hergestellt wird und die Verbindung ipSec-Verschlüsselung verwendet.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile mprapi.h

Weitere Informationen

Referenz zur Routerverwaltung

Routerverwaltungsstrukturen