Prev Next
The RASPPPIP structure contains the result of a PPP Internet Protocol
(IP) projection operation.
The RasGetProjectionInfo function
returns a RASPPPIP data structure when its rasprojection
parameter has the value RASP_PppIp.
typedef struct _RASPPPIP {
DWORD dwSize;
DWORD dwError;
TCHAR szIpAddress[ RAS_MaxIpAddress + 1 ];
} RASPPPIP;
Members
-
dwSize
-
Specifies the size of the structure, in bytes. Before calling the RasGetProjectionInfo
function, set this member to indicate the version of the RASPPPIP
structure that you are using. For information about earlier versions of this
structure, see the following Remarks section.
-
dwError
-
Contains the result of the PPP control protocol negotiation. A value of zero
indicates success. A nonzero value indicates failure, and is the actual fatal
error that occurred during the control protocol negotiation, the error that
prevented the projection from completing successfully.
-
szIpAddress
-
Contains a zero-terminated string that is the client’s IP address on the RAS
connection. This address string has the form a.b.c.d;
for example, “11.101.237.71”.
-
szServerIpAddress
-
Contains a null-terminated string that is the IP address of the remote PPP
peer (that is, the server's IP address). This string is in
"a.b.c.d" form. PPP does not require that servers provide this
address, but Windows NT servers will consistently return the address anyway.
Other PPP vendors may not provide the address. If the address is not
available, this member returns an empty string, "".
Remarks
The szServerIpAddress member was added to the RASPPPIP structure
beginning with Windows NT 3.51 and the initial release of Windows 95.
Beginning with these systems, RasGetProjectionInfo will support both
the current form of the structure and the old form without the szServerIpAddress
member. Use the dwSize member to indicate which version you are using.
For earlier versions of Windows NT, RasGetProjectionInfo will return
ERROR_INVALID_SIZE if dwSize specifies the current structure size. To
retrieve PPP IP information from older systems, dwSize must specify the
size of the old structure without the szServerIpAddress member.
See Also
RasGetProjectionInfo, RASPROJECTION
Questions: