ConnMgrConnectionStatus

SDK Documentation for Windows Mobile-Based Pocket PCs

The ConnMgrConnectionStatus function returns the status of the current connection.

Syntax

HRESULT WINAPI ConnMgrConnectionStatus(
  HANDLE hConnection,
  DWORD * pdwStatus 
);

Parameters

hConnection

Handle to the current connection; the ConnMgrEstablishConnectionSync function returns the value of this parameter.

pdwStatus

Pointer to the final status value of the function. The following table lists the possible values of this parameter.

Value	Description
CONNMGR_STATUS_UNKNOWN	The status is unknown.
CONNMGR_STATUS_CONNECTED	The connection is up.
CONNMGR_STATUS_DISCONNECTED	The connection has been disconnected.
CONNMGR_STATUS_WAITINGFORPATH	A path to the destination exists but is not presently available (for example, the device is out of radio range or is not plugged into its cradle).
CONNMGR_STATUS_WAITINGFORRESOURCE	Another client is using resources that this connection requires.
CONNMGR_STATUS_WAITINGFORPHONE	A voice call is in progress and is using resources that this connection requires.
CONNMGR_STATUS_WAITINGFORNETWORK	The device is waiting for a task with a higher priority to connect to the network before connecting to the same network. This status value is returned only to clients that specify a priority of CONNMGR_PRIORITY_LOWBKGND when requesting a connection.
CONNMGR_STATUS_NOPATHTODESTINATION	No path to the destination could be found.
CONNMGR_STATUS_CONNECTIONFAILED	The connection failed and cannot be reestablished.
CONNMGR_STATUS_CONNECTIONCANCELED	The user aborted the connection.
CONNMGR_STATUS_CONNECTIONDISABLED	The connection can be made, but the connection itself is disabled. This value is returned only to clients that set the bDisabled value in the CONNMGR_CONNECTIONINFO structure.
CONNMGR_STATUS_WAITINGCONNECTION	The device is attempting to connect.
CONNMGR_STATUS_WAITINGCONNECTIONABORT	The device is aborting the connection attempt.
CONNMGR_STATUS_WAITINGDISCONNECTION	The connection is being brought down.

Return Values

None.

Requirements

Pocket PC: Windows Mobile 2000 and later
OS Versions: Windows CE 3.0 and later
Header: connmgr.h
Library: cellcore.lib

Syntax

Parameters

Return Values

Requirements

See Also