Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
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.

dwParams

Combination of Connection Manager detailed status parameter constants. See Connection Manager Detailed Status Parameter Constants.

dwType

One of the connection type constants. For possible values, see Connection Manager Connection Type Constants.

dwSubtype

One of the connection subtype constants. For possible values, see Connection Manager Connection Subtype Constants.

dwFlags

One or more connection options. For possible values, see Connection Manager Connection Options Constants.

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.

dwConnectionStatus

One of the Connection Manager status constants. For possible values, see Connection Manager Status Constants.

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_STATUScontains information about the status of a Wi-Fi connection, the szDescriptionfield 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