RASCONNSTATUS
A RASCONNSTATUS
structure describes the current status of a remote access connection. It is
returned by the RasGetConnectStatus function.
typedef struct _RASCONNSTATUS {
DWORD dwSize;
RASCONNSTATE rasconnstate;
DWORD dwError;
TCHAR szDeviceType[RAS_MaxDeviceType + 1];
TCHAR szDeviceName[RAS_MaxDeviceName + 1];
} RASCONNSTATUS;
Members
dwSize
Specifies the
structure size, in bytes.
rasconnstate
Specifies a RASCONNSTATE enumerator value that
indicates the current state of the RasDial connection process; that is, the piece of the RasDial
process that is currently executing.
Two state values are especially significant:
|
State |
Meaning |
|
RASCS_Connected |
Indicates
that the connection has been successfully established. |
|
RASCS_Disconnected |
Indicates
that the connection has failed. |
dwError
If nonzero,
indicates the reason for failure. The value is one of the error values from the
RAS header file or one of ERROR_NOT_ENOUGH_MEMORY or ERROR_INVALID_HANDLE.
szDeviceType
A string that
specifies the type of the current device, if available. For example, common
device types supported by RAS are modem , pad , switch , isdn , or null .
szDeviceName
A string that
specifies the name of the current device, if available. This would be the name
of the modem for
example, Hayes Smartmodem 2400 ; the name of the PAD, for example US Sprint ;
or the name of a switch device, for example Racal-Guardata .
See Also