CONNMGR_CONNECTION_DETAILED_STATUS

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure contains detailed information about the status of available connections.

Syntax

typedef struct _CONNMGR_CONNECTION_DETAILED_STATUS{
  struct _CONNMGR_CONNECTION_DETAILED_STATUS* pNext;
  DWORD dwVer; 
  DWORD dwParams;
  DWORD dwType; 
  DWORD dwSubtype;
  DWORD dwFlags; 
  DWORD dwSecure;
  GUID guidDestNet;
  GUID guidSourceNet; 
  TCHAR* szDescription;
  TCHAR* szAdapterName;
  DWORD dwConnectionStatus; 
  SYSTEMTIME LastConnectTime;
  DWORD dwSignalQuality; 
  CONNMGR_CONNECTION_IPADDR* pIPAddr;
} CONNMGR_CONNECTION_DETAILED_STATUS;

Members

  • pNext
    Points to the next connection in the connection list, or NULL if there are no more connections. The connection list is obtained using ConnMgrQueryDetailedStatus.
  • dwVer
    Version of the structure. The current version is set to CONNMGRDETAILEDSTATUS_VERSION.
  • dwSecure
    The security level of the connection. The security level corresponds to the connection type. A value greater than zero sets the connection type to more secure.
  • guidDestNet
    GUID of the destination network.
  • guidSourceNet
    GUID of the source network.
  • szDescription
    Name of the connection specified in a null-terminated string. If no name is available, this parameter must be set to NULL.
  • szAdapterName
    Null-terminated name of the adapter. If no adapter name is available, this parameter must be set to NULL.
  • LastConnectTime
    Time the connection was last established.
  • dwSignalQuality
    Quality of the signal; can be a value between 0 and 255.
  • pIPAddr
    Available IP addresses, set to NULL, if no IP address is available.

Remarks

When CONNMGR_CONNECTION_DETAILED_STATUS contains information about the status of a Wi-Fi connection, the szDescription field contains the name of the service set identifier (SSID) used to connect to the network. You can query the SSID by calling ConnMgrQueryDetailedStatus.

Requirements

Header connmgr_status.h
Windows Embedded CE Windows CE .NET 4.2 and later, Windows Embedded NavReady 2009
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

ConnMgrQueryDetailedStatus
Connection Manager Status Constants
Connection Manager Connection Type Constants

Other Resources