IKEV2_PROJECTION_INFO-Struktur (mprapi.h)

Artikel
08/24/2023

Die IKEV2_PROJECTION_INFO-Struktur enthält Informationen, die während der IKE-Aushandlung (Internet Key Exchange) abgerufen wurden.

Syntax

typedef struct _IKEV2_PROJECTION_INFO {
  DWORD   dwIPv4NegotiationError;
  WCHAR   wszAddress[IPADDRESSLEN + 1];
  WCHAR   wszRemoteAddress[IPADDRESSLEN + 1];
  ULONG64 IPv4SubInterfaceIndex;
  DWORD   dwIPv6NegotiationError;
  BYTE    bInterfaceIdentifier[8];
  BYTE    bRemoteInterfaceIdentifier[8];
  BYTE    bPrefix[8];
  DWORD   dwPrefixLength;
  ULONG64 IPv6SubInterfaceIndex;
  DWORD   dwOptions;
  DWORD   dwAuthenticationProtocol;
  DWORD   dwEapTypeId;
  DWORD   dwCompressionAlgorithm;
  DWORD   dwEncryptionMethod;
} IKEV2_PROJECTION_INFO, *PIKEV2_PROJECTION_INFO;

Members

dwIPv4NegotiationError

Ein Wert, der das Ergebnis der IPv4-Aushandlung angibt. Der Wert null gibt an, dass eine IPv4-Adresse erfolgreich zugewiesen wurde. Ein wert nonzero gibt einen Fehler an und ist der schwerwiegende Fehler, der während der Aushandlung 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.

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 IPv6-Aushandlung angibt. Der Wert null gibt an, dass eine IPv6-Adresse erfolgreich ausgehandelt wurde. Ein wert nonzero gibt einen Fehler an und ist der schwerwiegende Fehler, der während der Aushandlung 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.

dwOptions

Wird nicht verwendet.

dwAuthenticationProtocol

Ein Wert, der das Authentifizierungsprotokoll angibt, das zum Authentifizieren des Remoteservers verwendet wird. Die folgenden Authentifizierungsprotokolle werden unterstützt:

Wert	Bedeutung
MPRAPI_IKEV2_AUTH_USING_CERT	X.509 Public Key Infrastructure Certificate (RFC 2459)
MPRAPI_IKEV2_AUTH_USING_EAP	Extensible Authentication-Protokoll

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

dwCompressionAlgorithm

Wird nicht verwendet.

dwEncryptionMethod

Ein Wert, der die Verschlüsselungsmethode angibt, die in der Verbindung verwendet wird. Die folgenden Verschlüsselungsmethoden werden unterstützt:

Wert	Bedeutung
IPSEC_CIPHER_TYPE_3DES	3DES-Verschlüsselung
IPSEC_CIPHER_TYPE_AES_128	AES-128-Verschlüsselung
IPSEC_CIPHER_TYPE_AES_192	AES-192-Verschlüsselung
IPSEC_CIPHER_TYPE_AES_256	AES-256-Verschlüsselung

Anforderungen


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