RASPPP_PROJECTION_INFO structure (ras.h)
The RASPPP_PROJECTION_INFO structure contains information obtained during Point-to-Point (PPP) negotiation of Internet Protocol version 4 (IPv4) and IPv6 projection operations, and PPP Link Control Protocol (LCP)/multilink, and Compression Control Protocol (CCP) negotiation.
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;
Members
dwIPv4NegotiationError
A value that specifies the result of PPP IPv4 network control protocol negotiation. A value of zero indicates Ipv4 has been negotiated successfully. A nonzero value indicates failure, and is the fatal error that occurred during the control protocol negotiation.
ipv4Address
A RASIPV4ADDR 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 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.
dwIPv4Options
A value that specifies Internet Protocol Control Protocol (IPCP) options for the local client.
| Value | Meaning |
|---|---|
|
Indicates that IP datagrams sent by the local client are compressed using Van Jacobson compression. |
dwIPv4ServerOptions
A value that specifies IPCP options for the remote server.
| Value | Meaning |
|---|---|
|
Indicates that IP datagrams sent by the remote server (that is, received by the local computer) are compressed using Van Jacobson compression. |
dwIPv6NegotiationError
A value that specifies the result of PPP IPv6 network control protocol negotiation. A value of zero indicates Ipv6 has been negotiated successfully. A nonzero value indicates failure, and is the fatal error that occurred during the control protocol negotiation.
bInterfaceIdentifier[8]
An array that specifies the 64-bit IPv6 interface identifier of the client. The last 64 bits of a 128-bit IPv6 internet address are considered the "interface identifier," which provides a strong level of uniqueness for the preceding 64-bits. bInterfaceIdentifier must not be zero and is valid only if dwIPv6NegotiationError is zero.
bServerInterfaceIdentifier[8]
An array that specifies the 64-bit IPv6 interface identifier of the server. The last 64 bits of a 128-bit IPv6 internet address are considered the "interface identifier," which provides a strong level of uniqueness for the preceding 64-bits. bServerInterfaceIdentifier must not be zero and is valid only if dwIPv6NegotiationError is zero.
fBundled
A BOOL that is TRUE if the connection is composed of multiple links and FALSE otherwise.
fMultilink
A BOOL that is TRUE if the connection supports multiple links and FALSE otherwise.
dwAuthenticationProtocol
A value that specifies the authentication protocol used to authenticate the local client. This member can be one of the following values.
dwAuthenticationData
A value that specifies additional information about the authentication protocol specified by dwAuthenticationProtocol. dwAuthenticationData and dwServerAuthenticationData when different authentication protocols on the client and server. This member can be one of the following values:
| Value | Meaning |
|---|---|
|
MD5 CHAP. |
|
Microsoft CHAP. |
|
Microsoft CHAP version 2. |
dwServerAuthenticationProtocol
A value that specifies the authentication protocol used to authenticate the remote server. This member can be one of the following values:
dwServerAuthenticationData
A value that specifies additional information about the authentication protocol specified by dwServerAuthenticationProtocol. dwAuthenticationData and dwServerAuthenticationData when different authentication protocols on the client and server. This member can be one of the following values:
| Value | Meaning |
|---|---|
|
MD5 CHAP. |
|
Microsoft CHAP. |
|
Microsoft CHAP version 2. |
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 RASLCPAPP_EAP..
dwServerEapTypeId
A value that specifies the type identifier of the Extensible Authentication Protocol (EAP) used to authenticate the remote server. The value of this member is valid only if dwRemoteAuthenticationProtocol is RASLCPAPP_EAP..
dwLcpOptions
A value that specifies information about LCP options in use by the local client. This member is a combination of the following flags:
| Value | Meaning |
|---|---|
|
The connection is using Protocol Field Compression (RFC 1172). |
|
The connection is using Address and Control Field Compression (RFC 1172). |
|
The connection is using Short Sequence Number Header Format (see RFC 1990). |
|
The connection is using DES 56-bit encryption. |
|
The connection is using Triple DES Encryption. |
dwLcpServerOptions
A value that specifies information about LCP options in use by the remote server. This member is a combination of the following flags:
| Value | Meaning |
|---|---|
|
The connection is using Protocol Field Compression (RFC 1172). |
|
The connection is using Address and Control Field Compression (RFC 1172). |
|
The connection is using Short Sequence Number Header Format (see RFC 1990). |
|
The connection is using DES 56-bit encryption. |
|
The connection is using Triple DES Encryption. |
dwCcpError
dwCcpCompressionAlgorithm
A value that specifies the compression algorithm used by the local client. The following table shows the possible values for this member.
| Value | Meaning |
|---|---|
|
Microsoft Point-to-Point Compression (MPPC) Protocol (RFC 2118). |
|
STAC option 4 (RFC 1974). |
dwCcpServerCompressionAlgorithm
A value that specifies the compression algorithm used by the remote server. The following algorithms are supported:
| Value | Meaning |
|---|---|
|
Microsoft Point-to-Point Compression (MPPC) Protocol ( RFC 2118). |
|
STAC option 4 ( RFC 1974). |
dwCcpOptions
A value that specifies the compression types available on the local client. The following types are supported:
dwCcpServerOptions
A value that specifies the compression types available on the remote server. The following types are supported:
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 7 [desktop apps only] |
| Minimum supported server | Windows Server 2008 R2 [desktop apps only] |
| Header | ras.h |
See also
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for