RasGetConnectStatus
The RasGetConnectStatus
function retrieves information on the current status of the specified remote
access connection. An application can use this call to determine when an
asynchronous RasDial
call has completed.
DWORD RasGetConnectStatus(
|
HRASCONN hrasconn, |
// handle to RAS
connection of interest |
|
LPRASCONNSTATUS lprasconnstatus |
// buffer to
receive status data |
|
); |
|
Parameters
hrasconn
Identifies
the remote access connection for which to retrieve the status. This handle must
have been obtained from RasDial or RasEnumConnections.
lprasconnstatus
Points to a RASCONNSTATUS structure that the function
fills with status information. Before calling the function, an application must
set the dwSize member of the structure to sizeof(RASCONNSTATUS)
in order to identify the version of the structure being passed.
Return Values
If the
function succeeds, the return value is zero.
If the function
fails, the return value is a nonzero error value listed in the RAS header file
or one of ERROR_BUFFER_TOO_SMALL or ERROR_NOT_ENOUGH_MEMORY.
See Also