Share via


AutoDialGetConnectionStatus (Compact 2013)

3/26/2014

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

See Also

Reference

ICS Functions