RASPPPIP

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure contains the result of a PPP IP projection operation.

The RasGetProjectionInfo function returns a RASPPPIP structure when its rasprojection parameter has the value RASP_PppIp.

Syntax

#define RASPPPIPW struct tagRASPPPIPW
RASPPPIPW
{ 
    // Required members
  DWORD dwSize; 
  DWORD dwError; 
  TCHAR szIpAddress[ RAS_MaxIpAddress + 1 ]; 
  // Optional members
  WCHAR szServerIpAddress[ RAS_MaxIpAddress + 1 ];
  DWORD dwOptions;
  DWORD dwServerOptions;
};
#define RASPPPIP RASPPPIPW

Members

• dwSize
  Required. Specifies the size of the structure, in bytes. Before calling the RasGetProjectionInfo function, set this member to indicate the cumulative size of the members of the RASPPPIP structure that you are using. For information about earlier versions of this structure, see the Remarks section.

• dwError
  Required. Contains the result of the PPP control protocol negotiation. A value of zero indicates success. A nonzero value indicates failure. The value given indicates the particular error that occurred during the control protocol negotiation.

• szIpAddress
  Required. Contains a null-terminated string that is the client's IP address on the RAS connection. For example, 11.101.237.71.

• szServerIpAddress
  Optional. Contains a null-terminated string that is the server's IP address on the RAS connection. For example, 11.101.237.72.

• dwOptions
  Optional. Specifies Internet Protocol Control Protocol (IPCP) options for the local client. The only currently accepted value is RASIPO_VJ, which indicates that IP datagrams sent by the local computer are compressed using Van Jacobson compression.

• dwServerOptions
  Optional. Specifies IPCP options for the remote server. The only currently accepted value is RASIPO_VJ, which indicates that IP datagrams sent by the remote computer are compressed using Van Jacobson compression.

Remarks

To retrieve PPP IP information on Windows Embedded CE–based devices, dwSize must specify the size of the RASPPPIP structure that indicates the cumulative size of all members you are using. The dwSize member must at least contain the size of the required members; dwSize, dwError, and szIpAddress. Additionally, dwSize should contain the size of each of the optional members you use; szServerIpAddress, dwOptions, and dwServerOptions.

Requirements

See Also

Reference

RasGetProjectionInfo
RASPROJECTION