PPPStatus
Deprecated. Do not use in new code.
(Engine-Level Function)
Description: | Obtains the structure of a PPP connection. |
Returns: | A structure describing the state. See comments |
Usage: | Script or steady state. |
Function Groups: | Modem, Serial Port |
Related to: | PPPDial | PPPStatus |
Format: | PPPStatus(PPPHandle) |
Parameters: |
PPPHandle |
The PPP Handle to be monitored. |
Comments: | If called in script mode, the current state will be returned. If called in steady state, the function will be retriggered each time there is a state change in the parameter, PPPHandle. The return value is a structure containing the following members: ConnectionID: Actually the phonebook entry name, which is a GUID. State: See enumeration RASCONNSTATE (defined in the Visual Studio file, ras.h) Error: Last error code from RAS (defined in the Visual Studio file, raserror.h) RemoteIP: The IP address of the remote peer. Only valid when State is RASCS_Projected or greater. LocalIP: The IP address on this machine that the remote peer is connected to. Only valid when State is RASCS_Projected or greater. If the PPPHandle parameter is bad, this function will return an Invalid. |