}    return rtn;}// ----------------------------------------------------------------------------/* make sure a connection has been established */static utBool _wceGprsConnect(HRASCONN *pRasConn){    const char *entryName = propGetString(PROP_COMM_CONNECTION, DEFAULT_ENTRY_NAME);    if (pRasConn) { *pRasConn = NULL; }    /* already connected? */    HRASCONN hExistingRasConn = wceGprsGetConnection(entryName);    if (wceGprsIsConnected(hExistingRasConn)) {        logDEBUG(LOGSRC,"GPRS already connected: %s", entryName);        _wceResetTimerLong  = 0L;        _wceResetTimerShort = 0L;        if (pRasConn) { *pRasConn = hExistingRasConn; }        return utTrue;    }    //logDEBUG(LOGSRC,"GPRS attempt connection: %s", entryName);    /* signal strength */    // check signal strength here    /* RASDIALPARAMS structure */    RASDIALPARAMS rasDialParms;    memset(&rasDialParms, 0, sizeof(rasDialParms));    rasDialParms.dwSize = sizeof(rasDialParms);    strWideCopy(rasDialParms.szEntryName, RAS_MaxEntryName, entryName, -1);    /* init RAS configuration from system parameters */    BOOL hasRasParams = FALSE;    BOOL inclPass = FALSE;	DWORD rasEntryErr = RasGetEntryDialParams(NULL, &rasDialParms, &inclPass);    if (rasEntryErr) {        // Possible errors:        //  1168  ERROR_NOT_FOUND   Element not found        logERROR(LOGSRC,"No dial params [%ld]: %ls", rasEntryErr, rasDialParms.szEntryName);        //return utFalse;    } else {        hasRasParams = TRUE;    }    //logINFO(LOGSRC,"S) inclPass : %d\n" , inclPass);    /* override parameters */    // szPhoneNumber    const char *phoneNum = propGetString(PROP_COMM_APN_PHONE, "");    if (phoneNum && *phoneNum) {        strWideCopy(rasDialParms.szPhoneNumber, RAS_MaxPhoneNumber, phoneNum, -1);        hasRasParams = TRUE;    }    // szCallbackNumber    const char *callback = "";    if (callback && *callback) {        strWideCopy(rasDialParms.szCallbackNumber, RAS_MaxCallbackNumber, callback, -1);        hasRasParams = TRUE;    }    // szUserName    const char *apnUser = propGetString(PROP_COMM_APN_USER,"");    if (apnUser && *apnUser) {        strWideCopy(rasDialParms.szUserName, UNLEN, apnUser, -1);        hasRasParams = TRUE;    }    // szPassword    const char *apnPass = propGetString(PROP_COMM_APN_PASSWORD,"");    if (apnPass && *apnPass) {        strWideCopy(rasDialParms.szPassword, PWLEN, apnPass, -1);        hasRasParams = TRUE;    }    // szDomain    const char *apnDomain = propGetString(PROP_COMM_APN_SERVER,"");    if (apnDomain && *apnDomain) {        strWideCopy(rasDialParms.szDomain, DNLEN, apnDomain, -1);        hasRasParams = TRUE;    }        /* do we have any dialing parameters? */    if (!hasRasParams) {        logERROR(LOGSRC,"No RAS dialing parameters!");        return utFalse;    }    /* Dial/Connect */#if defined(WCEGPRS_CONNECT_VIA_RASDIAL_EXE)    // External RASDIAL connection here (if implemented)#else    // "RasDial(...)" appears to have its share of problems:    // - On several occasions, 'RasDial' has caused the program to terminate.    // - On at least one occasion, a call to 'RasDial' never returned.  I suspect    //   that it had terminated the current thread.    // - 'RasDial' may get in an endless 'ERROR_PORT_DISCONNECTED' error loop even    //   though a valid SIM card is in place and GPRS coverage is fine.  (I've been    //   able to recover in this situation by hard-resetting the phone).    /* call 'RasDial(...)' */    // In marginal GPRS coverage, this call can hang for more than 60 seconds     // before returning a failed connection attempt.    UInt32 rasDialStartTime = utcGetTimeSec();    logDEBUG(LOGSRC,"[%lu] 'RasDial' start ...", rasDialStartTime);    HRASCONN hRasConn = NULL;    DWORD rasDialErr = RasDial(NULL,NULL,&rasDialParms,NULL,NULL,&hRasConn);    UInt32 rasDialEndTime = utcGetTimeSec();    logDEBUG(LOGSRC,"[%lu] 'RasDial' end ... [%ld sec]", rasDialEndTime, (rasDialEndTime - rasDialStartTime));    if (pRasConn) { *pRasConn = hRasConn; }        /* check returned errors */	if (rasDialErr != SUCCESS) {        // Errors encountered (see 'raserror.h' for a complete list)        // 604  ERROR_WRONG_INFO_SPECIFIED  [may be sent when GPRS is unavailable]        // 608  ERROR_DEVICE_DOES_NOT_EXIST [likely an invalid entry name]        // 619  ERROR_PORT_DISCONNECTED     [may already be connected]        // 631  ERROR_USER_DISCONNECTION        // 633  ERROR_PORT_NOT_AVAILABLE        // 660  ERROR_NO_RESPONSES        // 679  ERROR_NO_CARRIER        // ---------------------------------                /* hang-up */        if (hRasConn) {            wceGprsDisconnect(hRasConn);        } else {            // wait here even if 'RasDial' failed and 'hRasConn' is null            threadSleepMS(3500L);        }                /* check specific error */        if (rasDialErr == ERROR_WRONG_INFO_SPECIFIED) {            // - I've seen this error occur when either GPRS is unavailable, or the            // phone is turned off.  For now, just continue with the retry ...        } else        if (rasDialErr == ERROR_PORT_DISCONNECTED) {            // - This most likely indicates that GPRS coverage is not available.            // - When this error occurs multiple times and GPRS *IS* available, I've been             //   able to recover by manually turning off the phone connection, then turning             //   it back on (while testing on an HP hw6945).  In an attempt to perform this             //   reset automatically, we'll try to detect this state and attempt to hang-up             //   the connection, hopefully clearing this error state on the next iteration.            //   This will not be effective if GPRS coverage is not available.            // - This error may also occur if the SIM card is not installed, in which            //   case this error will continue forever.            logERROR(LOGSRC,"RasDial ERROR_PORT_DISCONNECTED [%ld]", (Int32)rasDialErr);        } else        if (rasDialErr == ERROR_PORT_NOT_AVAILABLE) {            // - This likely indicates that the phone/modem is locked up and unusable.            // - Or we may actually be connected, but under a different entry-name.            // - This error can also occur if the SIM card is not installed, in which            //   case this error will continue forever.            logERROR(LOGSRC,"RasDial ERROR_PORT_NOT_AVAILABLE [%ld]", (Int32)rasDialErr);        } else        if (rasDialErr == ERROR_DEVICE_DOES_NOT_EXIST) {            // - This likely indicates an invalid entry name            logERROR(LOGSRC,"RasDial ERROR_DEVICE_DOES_NOT_EXIST [%ld] - %s", (Int32)rasDialErr, entryName);            wceGprsListEntryNames(); // displa entry names         } else {            logINFO(LOGSRC,"RasDial connection failed [raserr=%ld]", (Int32)rasDialErr);        }                /* short timeout */        // Short timeouts specifically checks for ERROR_PORT_NOT_AVAILABLE errors.        // 'ERROR_PORT_NOT_AVAILABLE' errors may not be recoverable.        if (rasDialErr == ERROR_PORT_NOT_AVAILABLE) {            // we may not be able to recover without a rebbot, set a short timer            if (_wceResetTimerShort == 0L) {                // default reset timer, short delay                _wceResetTimerShort = utcGetTimer();            }        } else {            // we may be able to recover from non-port-not-available errors            _wceResetTimerShort = 0L;        }        /* long timeout */        // Long timeouts check for no connectivity, for any reason, for a long period of time.        if (_wceResetTimerLong == 0L) {            // default reset timer, long delay            _wceResetTimerLong = utcGetTimer();        }        /* check timeouts */        if ((MODEM_LONG_RESET_TIMEOUT > 0L) && (_wceResetTimerLong > 0L) &&             utcIsTimerExpired(_wceResetTimerLong,MODEM_LONG_RESET_TIMEOUT)) {            // we've been trying unsuccessfully for awhile now, just reset the modem            _wceResetTimerLong  = utcGetTimer();            _wceResetTimerShort = 0L;            wceGprsResetModem();            // (if we've rebooted, control should not reach here)        } else        if ((MODEM_SHORT_RESET_TIMEOUT > 0L) && (_wceResetTimerShort > 0L) &&             utcIsTimerExpired(_wceResetTimerShort,MODEM_SHORT_RESET_TIMEOUT)) {            // we've been trying unsuccessfully for awhile now, just reset the modem            _wceResetTimerLong  = utcGetTimer();            _wceResetTimerShort = 0L;            wceGprsResetModem();            // (if we've rebooted, control should not reach here)        }        /* 'continue' attempt */        // after a few minutes, start indicating that we've made a connection        // (the protocol transport will fail if it cannot actually transmit)        // we do this just-in-case this error is incorrect, which may in fact         // be the case if we are connected using a different "Connection name".        if (utcIsTimerExpired(_wceResetTimerLong,MODEM_CONTINUE_TIMEOUT)) {            logERROR(LOGSRC,"Continuing as if connected ...");            return utTrue;        }        /* connection failed */        return utFalse;    }    #endif // else defined(WCEGPRS_CONNECT_VIA_RASDIAL_EXE)    /* connected! */    logINFO(LOGSRC,"------- GPRS Connection Success ------");    _wceResetTimerLong  = 0L;    _wceResetTimerShort = 0L;    threadSleepMS(2000L);    return utTrue;}/* make sure a connection has been established */utBool wceGprsConnect(HRASCONN *pRasConn, utBool disconnectFirst){    utBool rtn = utFalse;    /* force a disconnect first? */    if (disconnectFirst && pRasConn) {        // This usually indicates that the caller was unable to establish a socket         // connection during the last GPRS connection.  Disconnect the previous         // failing connection before establishing a new connection.  In this         // situation, it is possible that if enough time has passed since the last        // socket-connection attempt, the OS may have already closed the old failing        // GPRS-connection and established a new one.  In which case we may be closing         // a good GPRS-connection.  There's no easy way to determine if the OS has        // in fact already established a connection, so going ahead and closing the        // current GPRS-connection, and establishing a new connection is the safest        // thing to do at this point.        logINFO(LOGSRC,"Forcing a disconnect before establishing a new connection");        wceGprsDisconnect(*pRasConn);    }    /* connect (may use an existing connection, if available) */    // This can take up to 60 seconds in a marginal GPRS coverage area.    rtn = _wceGprsConnect(pRasConn);        return rtn;}// ----------------------------------------------------------------------------#endif // defined(TARGET_WINCE)