RASIKEV2_PROJECTION_INFO structure

The RASIKEV2_PROJECTION_INFO structure contains projection information obtained during Internet Key Exchange (IKE) negotiation.

Syntax


typedef struct _RASIKEV2_PROJECTION_INFO {
  DWORD       dwIPv4NegotiationError;
  RASIPV4ADDR ipv4Address;
  RASIPV4ADDR ipv4ServerAddress;
  DWORD       dwIPv6NegotiationError;
  RASIPV6ADDR ipv6Address;
  RASIPV6ADDR ipv6ServerAddress;
  DWORD       dwPrefixLength;
  DWORD       dwAuthenticationProtocol;
  DWORD       dwEapTypeId;
  DWORD       dwFlags;
  DWORD       dwEncryptionMethod;
  DWORD       numIPv4ServerAddresses;
  RASIPV4ADDR *ipv4ServerAddresses;
  DWORD       numIPv6ServerAddresses;
  RASIPV6ADDR *ipv6ServerAddresses;
} RASIKEV2_PROJECTION_INFO, *PRASIKEV2_PROJECTION_INFO;

Members

dwIPv4NegotiationError

A value that specifies the result of IPv4 negotiation. A value of zero indicates an IPv4 address has been assigned successfully. A nonzero value indicates failure, and is the fatal error that occurred during negotiation.

ipv4Address

A RASIPV4ADDR structure that contains a null-terminated Unicode string that specifies the IPv4 address of the local client. This string has the form "a.b.c.d". ipv4Address is valid only if dwIPv4NegotiationError is zero.

ipv4ServerAddress

A RASIPV4ADDR structure that contains a null-terminated Unicode string that specifies the IPv4 address of the remote server. This string has the form "a.b.c.d". ipv4ServerAddress is valid only if dwIPv4NegotiationError is zero. If the address is not available, this member is an empty string.

dwIPv6NegotiationError

A value that specifies the result of IPv6 negotiation. A value of zero indicates an IPv6 address has been negotiated successfully. A nonzero value indicates failure, and is the fatal error that occurred during negotiation.

ipv6Address

A RASIPV6ADDR structure that contains a null-terminated Unicode string that specifies the IPv6 address of the local client. ipv6Address is valid only if dwIPv6NegotiationError is zero.

ipv6ServerAddress

A RASIPV6ADDR structure that contains a null-terminated Unicode string that specifies the IPv6 address of the remote server. ipv6ServerAddress is valid only if dwIPv6NegotiationError is zero. If the address is not available, this member is an empty string.

dwPrefixLength

A value that specifies the length, in bits, of the IPv6 address prefix.

dwAuthenticationProtocol

A value that specifies the authentication protocol used to authenticate the remote server. The following authentication protocols are supported:

ValueMeaning
RASIKEv2_AUTH_MACHINECERTIFICATES

X.509 Public Key Infrastructure Certificate (RFC 2459).

RASIKEv2_AUTH_EAP

Extensible Authentication Protocol.

 

dwEapTypeId

A value that specifies the type identifier of the Extensible Authentication Protocol (EAP) used to authenticate the local client. The value of this member is valid only if dwAuthenticationProtocol is RASIKEv2_AUTH_EAP.

dwFlags

A bitmap of flags that can be any combination of the following values:

ValueMeaning
RASIKEv2_FLAGS_MOBIKESUPPORTED

The client supports Mobile IKE (MOBIKE).

RASIKEv2_FLAGS_BEHIND_NAT

The client is behind Network Address Translation (NAT).

RASIKEv2_FLAGS_SERVERBEHIND_NAT

The server is behind Network Address Translation (NAT).

 

dwEncryptionMethod

A value that specifies the encryption method used in the connection. The following encryption methods are supported:

ValueMeaning
IPSEC_CIPHER_TYPE_3DES

3DES encryption.

IPSEC_CIPHER_TYPE_AES_128

AES-128 encryption.

IPSEC_CIPHER_TYPE_AES_192

AES-192 encryption.

IPSEC_CIPHER_TYPE_AES_256

AES-256 encryption.

 

numIPv4ServerAddresses

The number of available IPv4 addresses the server can switch to on the IKEv2 connection.

ipv4ServerAddresses

A pointer to a RASIPV4ADDR structure that contains the available IPv4 addresses the server can switch to on the IKEv2 connection.

numIPv6ServerAddresses

The number of available IPv6 addresses the server can switch to on the IKEv2 connection.

ipv6ServerAddresses

A pointer to a RASIPV6ADDR structure that contains the available IPv6 addresses the server can switch to on the IKEv2 connection.

Requirements

Minimum supported client

Windows 7 [desktop apps only]

Minimum supported server

Windows Server 2008 R2 [desktop apps only]

Header

Ras.h

See also

Remote Access Service (RAS) Overview
Remote Access Service Structures
RASPROJECTION_INFO_TYPE

 

 

Community Additions

ADD
Show:
© 2014 Microsoft