CONNMGR_CONNECTION_DETAILED_STATUS (Windows Embedded CE 6.0)
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.
- 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_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