IKEV2_PROJECTION_INFO2-Struktur (mprapi.h)

Enthält Informationen, die während der IKE-Aushandlung (Internet Key Exchange) abgerufen wurden.

Syntax

typedef struct _IKEV2_PROJECTION_INFO2 {
  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   dwEmbeddedEAPTypeId;
  DWORD   dwCompressionAlgorithm;
  DWORD   dwEncryptionMethod;
} IKEV2_PROJECTION_INFO2, *PIKEV2_PROJECTION_INFO2;

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]

Eine Unicode-Zeichenfolge mit Null-Beendigung, die die IPv4-Adresse des lokalen Clients angibt. Die Zeichenfolge hat das Format "a.b.c.d". Der wszAddress-Member ist nur gültig, wenn das dwIPv4NegotiationError-Element 0 ist.

wszRemoteAddress[IPADDRESSLEN + 1]

Eine Unicode-Zeichenfolge mit Null-Endung, die die IPv4-Adresse des Remoteservers angibt. Diese Zeichenfolge hat das Format "a.b.c.d". Der wszRemoteAddress-Member ist nur gültig, wenn das dwIPv4NegotiationError-Element 0 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 0 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. Der bInterfaceIdentifier-Member ist nur gültig, wenn der dwIPv6NegotiationError-Member 0 ist. Das bInterfaceIdentifier-Element darf nicht 0 sein.

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

bPrefix[8]

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

dwPrefixLength

Ein Wert, der die Länge des bPrefix-Elements in Bits angibt.

IPv6SubInterfaceIndex

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

dwOptions

Nicht implementiert.

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 (beschrieben in 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 das dwAuthenticationProtocol-ElementMPRAPI_IKEV2_AUTH_USING_EAP ist.

dwEmbeddedEAPTypeId

Ein Wert, der den Typbezeichner der inneren EAP-Methode angibt, die in der EAP-Authentifizierung verwendet wird. Der Wert dieses Members ist nur gültig, wenn das dwEapTypeId-Element auf PEAP festgelegt ist, das in IANA-EAP definiert ist.

dwCompressionAlgorithm

Nicht implementiert.

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 2012 [nur Desktop-Apps]
Kopfzeile	mprapi.h