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 |
|---|---|
|
X.509 Public Key Infrastructure Certificate (beschrieben in RFC 2459) |
|
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:
Anforderungen
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Kopfzeile | mprapi.h |