API Guide Home
(Online version only)

NetMasterLibErrors.h

Go to the documentation of this file.
00001 /******************************************************************************
00002  * Copyright (c) 2004 palmOne, Inc. or its subsidiaries.
00003  * All rights reserved.
00004  *****************************************************************************/
00005 /**
00006  * @ingroup NETMASTER
00007  */
00008 
00009 /**
00010  * @file    NetMasterLibErrors.h
00011  * @version 1.0
00012  * @date 01/31/2002
00013  *
00014  * @brief This  is the error declarations file for the NetMaster Library.
00015  *
00016  */
00017 
00018 #ifndef _NET_MASTER_LIB_ERRORS_H_
00019 #define _NET_MASTER_LIB_ERRORS_H_
00020 
00021 #include <HsErrorClasses.h>
00022 
00023 // WARNING:
00024 //    DO NOT MOVE OR REASSIGN ERROR CODE VALUES TO EXISTING CONSTANTS BECAUSE
00025 //    THEY ARE HARD-CODED IN OTHER MODULES, SUCH AS NETLIB PATCHES, SYSTEM
00026 //    PATCHES, AND ERROR STRING LISTS IN THE SYSTEM RESOURCE DATABASE.
00027 
00028 /** @name Net Master Error Codes
00029  */
00030 /**@{*/
00031 #define netMasterErrClass           (hsNetMasterErrorClass)     /**< hsNetMasterErrorClass is defined in HsErrorClasses.h as 0x7100 */
00032 #define netMasterErrMemory          (netMasterErrClass + 0x01)  /**< runtime memory error */
00033 #define netMasterErrStorage         (netMasterErrClass + 0x02)  /**< storage memory error */
00034 #define netMasterErrBadArg          (netMasterErrClass + 0x03)  /**< invalid argument, unknown ID */
00035 #define netMasterErrNetNotInstalled (netMasterErrClass + 0x04)  /**< NetLib has not been installed */
00036 #define netMasterErrDispatchTable   (netMasterErrClass + 0x05)  /**< Unrecognized dipatch table format */
00037 #define netMasterErrNoNetPrefLib    (netMasterErrClass + 0x06)  /**< NetPref library not found */
00038 #define netMasterErrConfigNotFound  (netMasterErrClass + 0x07)  /**< NetPref config not found */
00039 #define netMasterErrConfigFailed    (netMasterErrClass + 0x08)  /**< Attempt to configure network settings failed  */
00040 #define netMasterErrNo1xService     (netMasterErrClass + 0x09)  /**< 1xRTT is not available  */
00041 #define netMasterErrMIPFailed       (netMasterErrClass + 0x0A)  /**< Generic Mobile-IP failure  */
00042 #define netMasterErrBadPort         (netMasterErrClass + 0x0B)  /**< Invalid port number -- we remap this from serErrBadPort. */
00043 /**@}*/
00044 
00045 /** @name MIP Error Codes
00046  *  Sprint's Mobile-IP (MIP) error codes.
00047  */
00048 /**@{*/
00049 #define netMasterErrMIPNoSimBindings            (netMasterErrClass + 0x0C)  //
00050 #define netMasterErrMIPReasonUnspecified64      (netMasterErrClass + 0x0D)  //
00051 #define netMasterErrMIPAdminProhibited65        (netMasterErrClass + 0x0E)  //
00052 #define netMasterErrMIPInsufficientResources66  (netMasterErrClass + 0x0F)  //
00053 #define netMasterErrMIPMobileNodeAuth67         (netMasterErrClass + 0x10)  //
00054 #define netMasterErrMIPHomeAgentAuth68          (netMasterErrClass + 0x11)  //
00055 #define netMasterErrMIPReqLifetimeTooLong69     (netMasterErrClass + 0x12)  //
00056 #define netMasterErrMIPPoorlyFormedReq70        (netMasterErrClass + 0x13)  //
00057 #define netMasterErrMIPPoorlyFormedReply71      (netMasterErrClass + 0x14)  //
00058 #define netMasterErrMIPReqedEncapUnavail72      (netMasterErrClass + 0x15)  //
00059 #define netMasterErrMIPReservedNUnavail73       (netMasterErrClass + 0x16)  //
00060 #define netMasterErrMIPCantRevTun74             (netMasterErrClass + 0x17)  //
00061 #define netMasterErrMIPMustRevTun75             (netMasterErrClass + 0x18)  //
00062 #define netMasterErrMIPBadTtl76                 (netMasterErrClass + 0x19)  //
00063 #define netMasterErrMIPInvalidCareOfAddr77      (netMasterErrClass + 0x1A)  //
00064 #define netMasterErrMIPRegistration_Timeout78   (netMasterErrClass + 0x1B)  //
00065 #define netMasterErrMIPDelivStyleNotSupported79 (netMasterErrClass + 0x1C)  //
00066 #define netMasterErrMIPHome_Network_Unreachable80 (netMasterErrClass + 0x1D)    //
00067 #define netMasterErrMIPHa_Host_Unreachable81    (netMasterErrClass + 0x1E)  //
00068 #define netMasterErrMIPHa_Port_Unreachable82    (netMasterErrClass + 0x1F)  //
00069 #define netMasterErrMIPHa_Unreachable88         (netMasterErrClass + 0x20)  //
00070 #define netMasterErrMIPNonZeroHaRequested96     (netMasterErrClass + 0x21)  //
00071 #define netMasterErrMIPMissingNai97             (netMasterErrClass + 0x22)  //
00072 #define netMasterErrMIPForeign_Agent98          (netMasterErrClass + 0x23)  //
00073 #define netMasterErrMIPMissingHa99              (netMasterErrClass + 0x24)  //
00074 #define netMasterErrMIPErrorFa1_100             (netMasterErrClass + 0x25)  //
00075 #define netMasterErrMIPErrorFa2_101             (netMasterErrClass + 0x26)  //
00076 #define netMasterErrMIPUnknown_Challenge104     (netMasterErrClass + 0x27)  //
00077 #define netMasterErrMIPMissing_Challenge105     (netMasterErrClass + 0x28)  //
00078 #define netMasterErrMIPStale_Challenge106       (netMasterErrClass + 0x29)  //
00079 #define netMasterErrMIPReasonUnspecified128     (netMasterErrClass + 0x2A)  //
00080 #define netMasterErrMIPAdminProhibited129       (netMasterErrClass + 0x2B)  //
00081 #define netMasterErrMIPInsufficientResources130 (netMasterErrClass + 0x2C)  //
00082 #define netMasterErrMIPMobileNodeAuth131        (netMasterErrClass + 0x2D)  //
00083 #define netMasterErrMIPForeignAgentAuth132      (netMasterErrClass + 0x2E)  //
00084 #define netMasterErrMIPRegIdMismatch133         (netMasterErrClass + 0x2F)  //
00085 #define netMasterErrMIPPoorlyFormedReq134       (netMasterErrClass + 0x30)  //
00086 #define netMasterErrMIPTooManySimMobBindings135 (netMasterErrClass + 0x31)  //
00087 #define netMasterErrMIPUnknownHaAddr136         (netMasterErrClass + 0x32)  //
00088 #define netMasterErrMIPCantRevTun137            (netMasterErrClass + 0x33)  //
00089 #define netMasterErrMIPMustRevTun138            (netMasterErrClass + 0x34)  //
00090 #define netMasterErrMIPReqEncapNotAvail139      (netMasterErrClass + 0x35)  //
00091 #define netMasterErrMIPErrorHa1_140             (netMasterErrClass + 0x36)  //
00092 #define netMasterErrMIPErrorHa2_141             (netMasterErrClass + 0x37)  //
00093 
00094 /**
00095  * 801 Username suspension due to repeated incorrect passwords being sent
00096  */
00097 #define netMasterErrMIPUsernameSuspension801    (netMasterErrClass + 0x38)
00098 #define netMasterErrMIPReserved2                (netMasterErrClass + 0x39)  /**< Reserved for future use */
00099 #define netMasterErrMIPReserved3                (netMasterErrClass + 0x3A)  /**< Reserved for future use */
00100 #define netMasterErrMIPReserved4                (netMasterErrClass + 0x3B)  /**< Reserved for future use */
00101 /**@}*/
00102 
00103 /** @name Net Master Error Codes
00104  */
00105 /**@{*/
00106 
00107 #define netMasterErrAutoLoginNotPossible        (netMasterErrClass + 0x3C)  /**< auto-login did not take place */
00108 #define netMasterErrCDMACarrierNetworkBusy      (netMasterErrClass + 0x3D)  /**< "network busy" event was received from the carrier's network. */
00109 #define netMasterErrOneXServiceUnavailable      (netMasterErrClass + 0x3E)  /**<< requested service unavailable */
00110 
00111 /** Authentication UI prompt (such as username/password or script plug-in)
00112  *  was requested during background login -- this is not supported
00113  *  presently.
00114  */
00115 #define netMasterErrAuthReqDuringBGLogin        (netMasterErrClass + 0x3F)
00116 
00117 /** UI RPC timed out during a background-initiated login. This is an internal
00118  * error that might occur if the current UI app is not processing events
00119  * for a long time.
00120  */
00121 #define netMasterErrUIRPCTimeout                (netMasterErrClass + 0x40)
00122 
00123 /** @internal
00124  * INTERNAL ERROR (not returned outside of NetMaster lib). This may
00125  * be returned internally by various network setting configuration
00126  * routines to indicate that the level of service necessary to establish
00127  * the requested connection is not available (such as when a GPRS connection
00128  * is requested, but GPRS service is not available). When this error is
00129  * returned to the login logic, the login logic may still choose to attempt
00130  * the connection for the sole purpose of getting a more detailed error
00131  * code (which may not have been available during configuration) to display
00132  * to the user, or, if fallback is available, it may skip directly to the
00133  * fallback service.  When returning this error code, the configuration
00134  * routines still perform the full requested configuration.
00135  */
00136 #define netMasterErrInternalConnWouldBeImpossible (netMasterErrClass + 0x41)
00137 
00138 
00139 /** Net Guard prompt would have been required during background login. Prompting
00140  * is presently not supported during background login.
00141  */
00142 #define netMasterErrNetGuardReqDuringBGLogin    (netMasterErrClass + 0x42)
00143 
00144 
00145 /** Generic GPRS login error -- returned when we don't have enough specific
00146  * info about the cause of login failure.
00147  */
00148 #define netMasterErrGPRSGenLoginErr             (netMasterErrClass + 0x43)
00149 
00150 
00151 /** Sprint OneX service is unavailable while roaming
00152  */
00153 #define netMasterErrNoOneXServiceWhileRoaming   (netMasterErrClass + 0x44)
00154 
00155 /**@}*/
00156 
00157 
00158 // NOTE:
00159 // Assign error codes out of this unassigned error code block next.  These
00160 // error codes were inserted because someone mistakenly defined
00161 // netMasterErrOneXServiceNotEnabled as 0x4F instead of 0x3F in the
00162 // Visor3.5CDMA Maint branch, and we need to maintain that value for backward
00163 // compatibility. We need to account for all intervening error codes because
00164 // SysErrString and related functionality doesn't allow gaps in error strings.
00165 
00166 /** @name Reserved for future use
00167  */
00168 /**@{*/
00169 #define netMasterErrUnused45                    (netMasterErrClass + 0x45)  // assign this one next
00170 #define netMasterErrUnused46                    (netMasterErrClass + 0x46)  // assign this one next
00171 #define netMasterErrUnused47                    (netMasterErrClass + 0x47)  // assign this one next
00172 #define netMasterErrUnused48                    (netMasterErrClass + 0x48)  // assign this one next
00173 #define netMasterErrUnused49                    (netMasterErrClass + 0x49)  // assign this one next
00174 #define netMasterErrUnused4A                    (netMasterErrClass + 0x4A)  // assign this one next
00175 #define netMasterErrUnused4B                    (netMasterErrClass + 0x4B)  // assign this one next
00176 #define netMasterErrUnused4C                    (netMasterErrClass + 0x4C)  // assign this one next
00177 #define netMasterErrUnused4D                    (netMasterErrClass + 0x4D)  // assign this one next
00178 #define netMasterErrUnused4E                    (netMasterErrClass + 0x4E)  // assign this one next
00179 /**@}*/
00180 
00181 /** @name Net Master Error Codes
00182  */
00183 /**@{*/
00184 #define netMasterErrOneXServiceNotEnabled       (netMasterErrClass + 0x4F)  /**< modem doesn't support requested service */
00185 /**@}*/
00186 
00187 //End NetMaster error code group.
00188 
00189 
00190 #endif // _NET_MASTER_LIB_ERRORS_H_

Top Palm Developer Network
© 2004-2008, Palm, Inc. All rights reserved.
Generated on Fri Jun 13 10:06:54 2008 for Palm API Guide