CONNMGR_CONNECTION_DETAILED_STATUS (Windows Embedded CE 6.0)

  • Article

1/6/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

See Also

Reference

Connection Manager Structures
ConnMgrQueryDetailedStatus
Connection Manager Status Constants
Connection Manager Connection Type Constants

Other Resources