CONNMGR_CONNECTION_DETAILED_STATUS
This structure contains detailed information about the status of available connections.
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 with the connection type. If the security level is greater than zero, the connection is secure.This member can be set using the CM_VPNEntries configuration service provider. Use 1 for a secure connection and 0 for a non-secure connection.
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. OEMs can query the SSID using ConnMgrQueryDetailedStatus.
Requirements
OS Versions: Windows CE .NET 4.2 and later.
Header: Connmgr_status.h.
See Also
ConnMgrQueryDetailedStatus | Connection Manager Status Constants | Connection Manager Connection Type Constants
Send Feedback on this topic to the authors