Share via

ConnMgrConnectionStatus

  • Article

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

See Also

Connection Manager

Connection Manager API Structures

ConnMgrEstablishConnection

Send feedback on this topic to the authors.

© 2005 Microsoft Corporation. All rights reserved.