UDF That Gets the Ras Error Description

 Keywords:  UDF Ras Error Description

Udf_RasGetErrDesc Sample:

#DefineFunction Udf_RasGetErrDesc(err)
;if no error passed or invalid error
if err == 0 || err == "" || err < 601 
  ErrDesc = "*UNKNOWN*"
  return ErrDesc
endif
;redifine error
errorcode = err - 600

;Define all error strings
err1 = "The port handle is invalid."
err2 = "The port is already open."
err3 = "Caller's buffer is too small."
err4 = "Wrong information specified."
err5 = "Cannot set port information."
err6 = "The port is not connected."
err7 = "The event is invalid."
err8 = "The device does not exist."
err9 = "The device type does not exist."
err10 = "The buffer is invalid."
err11 = "The route is not available."
err12 = "The route is not allocated."
err13 = "Invalid compression specified."
err14 = "Out of buffers."
err15 = "The port was not found."
err16 = "An asynchronous request is pending."
err17 = "The port or device is already disconnecting."
err18 = "The port is not open."
err19 = "The port is disconnected."
err20 = "There are no endpoints."
err21 = "Cannot open the phone book file."
err22 = "Cannot load the phone book file."
err23 = "Cannot find the phone book entry."
err24 = "Cannot write the phone book file."
err25 = "Invalid information found in the phone book file."
err26 = "Cannot load a string."
err27 = "Cannot find key."
err28 = "The port was disconnected."
err29 = "The data link was terminated by the remote machine."
err30 = "The port was disconnected due to hardware failure."
err31 = "The port was disconnected by the user."
err32 = "The structure size is incorrect."
err33 = "The port is already in use or is not configured for Remote Access dial out."
err34 = "Cannot register your computer on on the remote network."
err35 = "Unknown error."
err36 = "The wrong device is attached to the port."
err37 = "The string could not be converted."
err38 = "The request has timed out."
err39 = "No asynchronous net available."
err40 = "A NetBIOS error has occurred."
err41 = "The server cannot allocate NetBIOS resources needed to support the client."
err42 = "One of your NetBIOS names is already registered on the remote network."
err43 = "A network adapter at the server failed."
err44 = "You will not receive network message popups."
err45 = "Internal authentication error."
err46 = "The account is not permitted to logon at this time of day."
err47 = "The account is disabled."
err48 = "The password has expired."
err49 = "The account does not have Remote Access permission."
err50 = "The Remote Access server is not responding."
err51 = "Your modem (or other connecting device) has reported an error."
err52 = "Unrecognized response from the device."
err53 = "A macro required by the device was not found in the device .INF file section."
err54 = "A command or response in the device .INF file section refers to an undefined macro."
err55 = "The  macro was not found in the device .INF file secion."
err56 = "The  macro in the device .INF file section contains an undefined macro."
err57 = "The device .INF file could not be opened."
err58 = "The device name in the device .INF or media .INI file is too long."
err59 = "The media .INI file refers to an unknown device name."
err60 = "The device .INF file contains no responses for the command."
err61 = "The device .INF file is missing a command."
err62 = "Attempted to set a macro not listed in device .INF file section."
err63 = "The media .INI file refers to an unknown device type."
err64 = "Cannot allocate memory."
err65 = "The port is not configured for Remote Access."
err66 = "Your modem (or other connecting device) is not functioning."
err67 = "Cannot read the media .INI file."
err68 = "The connection dropped."
err69 = "The usage parameter in the media .INI file is invalid."
err70 = "Cannot read the section name from the media .INI file."
err71 = "Cannot read the device type from the media .INI file."
err72 = "Cannot read the device name from the media .INI file."
err73 = "Cannot read the usage from the media .INI file."
err74 = "Cannot read the maximum connection BPS rate from the media .INI file."
err75 = "Cannot read the maximum carrier BPS rate from the media .INI file."
err76 = "The line is busy."
err77 = "A person answered instead of a modem."
err78 = "There is no answer."
err79 = "Cannot detect carrier."
err80 = "There is no dial tone."
err81 = "General error reported by device."
err82 = "ERROR_WRITING_SECTIONNAME"
err83 = "ERROR_WRITING_DEVICETYPE"
err84 = "ERROR_WRITING_DEVICENAME"
err85 = "ERROR_WRITING_MAXCONNECTBPS"
err86 = "ERROR_WRITING_MAXCARRIERBPS"
err87 = "ERROR_WRITING_USAGE"
err88 = "ERROR_WRITING_DEFAULTOFF"
err89 = "ERROR_READING_DEFAULTOFF"
err90 = "ERROR_EMPTY_INI_FILE"
err91 = "Access denied because username and/or password is invalid on the domain."
err92 = "Hardware failure in port or attached device."
err93 = "ERROR_NOT_BINARY_MACRO"
err94 = "ERROR_DCB_NOT_FOUND"
err95 = "ERROR_STATE_MACHINES_NOT_STARTED"
err96 = "ERROR_STATE_MACHINES_ALREADY_STARTED"
err97 = "ERROR_PARTIAL_RESPONSE_LOOPING"
err98 = "A response keyname in the device .INF file is not in the expected format."
err99 = "The device response caused buffer overflow."
err100 = "The expanded command in the device .INF file is too long."
err101 = "The device moved to a BPS rate not supported by the COM driver."
err102 = "Device response received when none expected."
err103 = "The Application does not allow user interaction. The connection requires interaction with the user to complete successfully. "
err104 = "ERROR_BAD_CALLBACK_NUMBER"
err105 = "ERROR_INVALID_AUTH_STATE"
err106 = "ERROR_WRITING_INITBPS"
err107 = "X.25 diagnostic indication."
err108 = "The account has expired."
err109 = "Error changing password on domain.  The password may be too short or may match a previously used password."
err110 = "Serial overrun errors were detected while communicating with your modem."
err111 = "RasMan initialization failure.  Check the event log."
err112 = "Biplex port initializing.  Wait a few seconds and redial."
err113 = "No active ISDN lines are available."
err114 = "No ISDN channels are available to make the call."
err115 = "Too many errors occurred because of poor phone line quality."
err116 = "The Remote Access IP configuration is unusable."
err117 = "No IP addresses are available in the static pool of Remote Access IP addresses."
err118 = "Timed out waiting for a valid response from the remote PPP peer."
err119 = "PPP terminated by remote machine."
err120 = "No PPP control protocols configured."
err121 = "Remote PPP peer is not responding."
err122 = "The PPP packet is invalid."
err123 = "The phone number including prefix and suffix is too long."
err124 = "The IPX protocol cannot dial-out on the port because the machine is an IPX router."
err125 = "The IPX protocol cannot dial-in on the port because the IPX router is not installed."
err126 = "The IPX protocol cannot be used for dial-out on more than one port at a time."
err127 = "Cannot access TCPCFG.DLL."
err128 = "Cannot find an IP adapter bound to Remote Access."
err129 = "SLIP cannot be used unless the IP protocol is installed."
err130 = "Computer registration is not complete."
err131 = "The protocol is not configured."
err132 = "The PPP negotiation is not converging."
err133 = "The PPP control protocol for this network protocol is not available on the server."
err134 = "The PPP link control protocol terminated."
err135 = "The requested address was rejected by the server."
err136 = "The remote computer terminated the control protocol."
err137 = "Loopback detected."
err138 = "The server did not assign an address."
err139 = "The authentication protocol required by the remote server cannot use the Windows NT encrypted password.  Redial, entering the password explicitly."
err140 = "Invalid TAPI configuration."
err141 = "The local computer does not support the required encryption type."
err142 = "The remote computer does not support the required encryption type."
err143 = "The remote computer requires encryption."
err144 = "Cannot use the IPX network number assigned by remote server.  Check the event log."
err145 = "ERROR_INVALID_SMM"
err146 = "ERROR_SMM_UNINITIALIZED"
err147 = "ERROR_NO_MAC_FOR_PORT"
err148 = "ERROR_SMM_TIMEOUT"
err149 = "ERROR_BAD_PHONE_NUMBER"
err150 = "ERROR_WRONG_MODULE"
err151 = "Invalid callback number.  Only the characters 0 to 9, T, P, W, (, ), -, @, and space are allowed in the number."
err152 = "A syntax error was encountered while processing a script."
err153 = "The connection could not be disconnected because it was created by the Multi-Protocol Router."
err154 = "The system could not find the multi-link bundle."
err155 = " The system cannot perform automated dial because this connection  has a custom dialer specified."
err156 = "This connection is already being dialed."
err157 = "Remote Access Services could not be started automatically. Additional information is provided in the event log."
err158 = "Internet Connection Sharing is already enabled on the connection."
err159 = "An error occurred while the existing Internet Connection Sharing settings were being changed."
err160 = "An error occurred while routing capabilities were being enabled."
err161 = "An error occurred while Internet Connection Sharing was being enabled for the connection."
err162 = "An error occurred while the local network was being configured for sharing."
err163 = "Internet Connection Sharing cannot be enabled. There is more than one LAN connection other than the connection to be shared."
err164 = "No smart card reader is installed."
err165 = "Internet Connection Sharing cannot be enabled. A LAN connection is already configured with the IP address that is required for automatic IP addressing."
err166 = "A certificate could not be found. Connections that use the L2TP protocol over IPSec require the installation of a machine certificate, also known as a computer certificate."
err167 = "Internet Connection Sharing cannot be enabled. The LAN connection selected as the private network has more than one IP address configured. Reconfigure LAN connection with single IP address before enabling Internet Connection Sharing."
err168 = "The connection attempt failed because of failure to encrypt data."
err169 = "The specified destination is not reachable."
err170 = "The remote computer rejected the connection attempt."
err171 = "The connection attempt failed because the network is busy."
err172 = "The remote computer's network hardware is incompatible with the type of call requested."
err173 = "The connection attempt failed because the destination number has changed."
err174 = "The connection attempt failed because of a temporary failure.  Try connecting again. "
err175 = "The call was blocked by the remote computer."
err176 = "The call could not be connected because the remote computer has invoked the Do Not Disturb feature."
err177 = "The connection attempt failed because the modem (or other connecting device) on the remote computer is out of order."
err178 = "It was not possible to verify the identity of the server."
err179 = "To dial out using this connection you must use a smart card."
err180 = "An attempted function is not valid for this connection."
err181 = "The encryption attempt failed because no valid certificate was found."
err182 = "Connection Sharing (NAT) is currently installed as a routing protocol, and must be  removed before enabling Internet Connection Sharing."
err183 = "Internet Connection Sharing cannot be enabled. The LAN connection selected as the private network is either not present, or is disconnected from the network. Ensure the LAN adapter is connected before enabling Internet Connection Sharing."
err184 = "You cannot dial using this connection at logon time, because it is configured to use a user name different than the one on the smart card. If you want to use it at logon time, you must configure it to use the user name on the smart card."
err185 = "You cannot dial using this connection at logon time, because it is not configured to use a smart card. If you want to use it at logon time, you must edit the properties of this connection so that it uses a smart card."
err186 = "The L2TP connection attempt failed because there is no valid machine certificate on your computer for security authentication."
err187 = "The L2TP connection attempt failed because the security layer could not authenticate the remote computer."
err188 = "The L2TP connection attempt failed because the security layer could not negotiate compatible parameters with the remote computer."
err189 = "The L2TP connection attempt failed because the security layer encountered a processing error during initial negotiations with the remote computer."
err190 = "The L2TP connection attempt failed because certificate validation on the remote computer failed."
err191 = "The L2TP connection attempt failed because security policy for the connection was not found."
err192 = "The L2TP connection attempt failed because security negotiation timed out."
err193 = "The L2TP connection attempt failed because an error occurred while negotiating security."
err194 = "The Framed Protocol RADIUS attribute for this user is not PPP."
err195 = "The Tunnel Type RADIUS attribute for this user is not correct. "
err196 = "The Service Type RADIUS attribute for this user is neither Framed nor Callback Framed."
err197 = "The connection failed because the modem (or other connecting device) was not found. Please make sure that the modem or other connecting device is installed."
err198 = "A certificate could not be found that can be used with this Extensible Authentication Protocol."

if isdefined("err%errorcode%")
   ErrDesc = err%errorcode% 
else
	ErrDesc = "*UNKNOWN*"
endif

return ErrDesc
#EndFunction


AddExtender("wwras34i.dll")
entryname = "XXX"; PASSING AN INVALID ENTRY NAME TO FORCE ERROR
BoxOpen("RAS Dialer","")
BoxText("Dialing %entryname%")
ErrorMode(@off)
connectionhandle = rasDial(entryname,"","","",0)
ErrorMode(@cancel)
if connectionhandle == 0
  err = rasGetLastErr ()
  desc = Udf_RasGetErrDesc(err)
  message("Connection error",StrCat(err,": ",desc))
  exit
endif 

numactvcons = rasNumCons()
BoxText("Number of Active connections %numactvcons%")
Timedelay(1)

ErrorMode(@off)
actvcons = rasListActCon()
ErrorMode(@cancel)
if actvcons == 0
  err = rasGetLastErr ()
  desc = Udf_RasGetErrDesc(err)
  message("rasListActCon error",StrCat(err,": ",desc))
  exit
endif 
BoxText("Active connections %actvcons%")

Timedelay(1)

con = ItemExtract(1,actvcons,@TAB)
handle = ItemExtract(2,con,"|")
status = rasConStatus(handle)
if status == 1
   BoxText("Status of connection 'Connected'")
else
   BoxText("Status of connection 'Disconnected'")
endif
TimeDelay(1)  

BoxText("Hanging up...")
rasHangUp(connectionhandle )
BoxText("Disconnected")
exit

Article ID:   W15089

File Created: 2002:09:05:13:49:28

Last Updated: 2002:09:05:13:49:28

Database Search

TechHome

UDF That Gets the Ras Error Description

Udf_RasGetErrDesc Sample: