Share via


AutoDialGetConnectionStatus (Windows Embedded CE 6.0)

1/6/2010

This function retrieves information about the current status of the specified auto dial connection.

Syntax

DWORD AutoDialGetConnectionStatus(
  RASCONNSTATUS* lpRasConn,
  TCHAR* szRasName
);

Parameters

  • lpRasConn
    [in] Long pointer to a buffer that receives a RASCONNSTATUS structure that describes the state of the active auto dial connection.
  • szRasName
    [out] Returns the name of the active auto dial connection. Returns NULL if no connection is active.

Return Value

If no error occurs, this function returns a value of ERROR_SUCCESS.

The following table shows the error values that are returned if an error occurs.

Error value Description

ERROR_INVALID_PARAMETER

The parameters in this function are not valid.

ERROR_RASAUTO_CANNOT_INITIALIZE

AutoDialInitializeModule was not called before calling AutoDialStartConnection.

ERROR_NO_CONNECTION

Disconnection or failed connection.

Remarks

If an error occurs, resources associated with RasDial are freed.

Requirements

Header autodial.h
Library Autodial.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

ICS Functions