Freigeben über


RASPPP_PROJECTION_INFO-Struktur (ras.h)

Die RASPPP_PROJECTION_INFO-Struktur enthält Informationen, die während der Point-to-Point-Aushandlung (PPP) der Internetprotokollversion 4 (IPv4) und IPv6-Projektionsvorgängen sowie der Aushandlung von PPP Link Control Protocol (LCP)/Multilink und CCP-Aushandlung (Compression Control Protocol) abgerufen wurden.

Syntax

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;

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.

ipv4Address

Eine RASIPV4ADDR , die eine Unicode-Zeichenfolge mit Null-Beendigung enthält, die die IPv4-Adresse des lokalen Clients angibt. Diese Zeichenfolge hat das Format "a.b.c.d". ipv4Address ist nur gültig, wenn dwIPv4NegotiationError null ist.

ipv4ServerAddress

Eine RASIPV4ADDR-Struktur , die eine Unicode-Zeichenfolge enthält, die die IPv4-Adresse des Remoteservers angibt. Diese Zeichenfolge hat das Format "a.b.c.d". ipv4ServerAddress 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 (Internet Protocol Control Protocol) für den lokalen Client angibt.

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

dwIPv4ServerOptions

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

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

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 darf nicht 0 sein und ist nur gültig, wenn dwIPv6NegotiationError 0 ist.

bServerInterfaceIdentifier[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. bServerInterfaceIdentifier darf nicht 0 sein und ist nur gültig, wenn dwIPv6NegotiationError 0 ist.

fBundled

Ein BOOL , der TRUE ist, wenn die Verbindung aus mehreren Links besteht, andernfalls FALSE .

fMultilink

Ein BOOL , der TRUE ist, wenn die Verbindung mehrere Links unterstützt, andernfalls FALSE .

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
RASLCPAP_PAP
Kennwortauthentifizierungsprotokoll.
RASLCPAP_SPAP
Shiva-Kennwortauthentifizierungsprotokoll.
RASLCPAP_CHAP
Challenge-Handshake-Authentifizierungsprotokoll.
RASLCPAP_EAP
Erweiterbares Authentifizierungsprotokoll.

dwAuthenticationData

Ein Wert, der zusätzliche Informationen zum Authentifizierungsprotokoll angibt, das von dwAuthenticationProtocol angegeben wird. dwAuthenticationData und dwServerAuthenticationData bei unterschiedlichen Authentifizierungsprotokollen auf dem Client und Server. Dieser Member kann einer der folgenden Werte sein:

Wert Bedeutung
RASLCPAD_CHAP_MD5
MD5 CHAP.
RASLCPAD_CHAP_MS
Microsoft CHAP.
RASLCPAD_CHAP_MSV2
Microsoft CHAP, Version 2.

dwServerAuthenticationProtocol

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

Wert Bedeutung
RASLCPAP_PAP
Kennwortauthentifizierungsprotokoll.
RASLCPAP_SPAP
Shiva-Kennwortauthentifizierungsprotokoll.
RASLCPAP_CHAP
Challenge-Handshake-Authentifizierungsprotokoll.
RASLCPAP_EAP
Erweiterbares Authentifizierungsprotokoll.

dwServerAuthenticationData

Ein Wert, der zusätzliche Informationen zum Authentifizierungsprotokoll angibt, das von dwServerAuthenticationProtocol angegeben wird. dwAuthenticationData und dwServerAuthenticationData bei unterschiedlichen Authentifizierungsprotokollen auf dem Client und Server. Dieser Member kann einer der folgenden Werte sein:

Wert Bedeutung
RASLCPAD_CHAP_MD5
MD5 CHAP.
RASLCPAD_CHAP_MS
Microsoft CHAP.
RASLCPAD_CHAP_MSV2
Microsoft CHAP, Version 2.

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 dwAuthenticationProtocolRASLCPAPP_EAP.. ist.

dwServerEapTypeId

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 dwRemoteAuthenticationProtocolRASLCPAPP_EAP.. ist.

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
RASLCPO_PFC
Die Verbindung verwendet Protokollfeldkomprimierung (RFC 1172).
RASLCPO_ACFC
Die Verbindung verwendet die Adress- und Steuerfeldkomprimierung (RFC 1172).
RASLCPO_SSHF
Die Verbindung verwendet das Headerformat für kurze Sequenznummern (siehe RFC 1990).
RASLCPO_DES_56
Die Verbindung verwendet die DES-56-Bit-Verschlüsselung.
RASLCPO_3_DES
Die Verbindung verwendet triple DES Encryption.

dwLcpServerOptions

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

Wert Bedeutung
RASLCPO_PFC
Die Verbindung verwendet Protokollfeldkomprimierung (RFC 1172).
RASLCPO_ACFC
Die Verbindung verwendet die Adress- und Steuerfeldkomprimierung (RFC 1172).
RASLCPO_SSHF
Die Verbindung verwendet das Headerformat für kurze Sequenznummern (siehe RFC 1990).
RASLCPO_DES_56
Die Verbindung verwendet die DES-56-Bit-Verschlüsselung.
RASLCPO_3_DES
Die Verbindung verwendet triple DES Encryption.

dwCcpError

dwCcpCompressionAlgorithm

Ein Wert, der den vom lokalen Client verwendeten Komprimierungsalgorithmus angibt. In der folgenden Tabelle sind die möglichen Werte für dieses Element aufgeführt.

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

dwCcpServerCompressionAlgorithm

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

dwCcpOptions

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

Wert Bedeutung
RASCCPO_COMPRESSION
Komprimierung ohne Verschlüsselung.
RASCCPO_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 ein erheblicher Paketverlust auftritt.
RASCCPO_ENCRYPTION40BITOLD
MPPE-Komprimierung mit 40-Bit-Schlüsseln.
RASCCPO_ENCRYPTION40BIT
MPPE-Komprimierung mit 40-Bit-Schlüsseln.
RASCCPO_ENCRYPTION56BIT
MPPE-Komprimierung mit 56-Bit-Schlüsseln.
RASCCPO_ENCRYPTION128BIT
MPPE-Komprimierung mit 128-Bit-Schlüsseln.

dwCcpServerOptions

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

Wert Bedeutung
RASCCPO_COMPRESSION
Komprimierung ohne Verschlüsselung.
RASCCPO_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 ein erheblicher Paketverlust auftritt.
RASCCPO_ENCRYPTION40BITOLD
MPPE-Komprimierung mit 40-Bit-Schlüsseln.
RASCCPO_ENCRYPTION40BIT
MPPE-Komprimierung mit 40-Bit-Schlüsseln.
RASCCPO_ENCRYPTION56BIT
MPPE-Komprimierung mit 56-Bit-Schlüsseln.
RASCCPO_ENCRYPTION128BIT
MPPE-Komprimierung mit 128-Bit-Schlüsseln.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile ras.h

Weitere Informationen

RasGetProjectionInfoEx

Ras-Dienst (Ras) – Übersicht

Remotezugriffsdienststrukturen