DialError

Returns the error codes regarding each connection.

Function	Group	Execution	Windows	Embedded	Thin Client
DialError	Dial-up	Synchronous	Supported (see note)	Supported	Supported

Syntax

DialError( numType, strPhonebookEntryOrModem, "optError", optRefresh )

numType

A numeric flag that specifies the content of the strPhonebookEntryorModem parameter.

0: Phonebook Name
1: Modem Name
2: Direct Connection Name

strPhonebookEntryOrModem

The Phonebook Name, Modem Name, or Direct Connection Name used to make the connection. The numType parameter specifies which of these methods is used.

optError

Optional The name of the string tag receiving the Error Message.

Note: The tag name must be enclosed in quotes, as shown in the syntax diagram, or else the project will try to get the value of the named tag.

optRefresh

Optional tag, which causes the function to update its return value. This parameter is optional but you must use it when configuring this function for an object animation (e.g., Text Data Link, Position).

Returned value

Value	Description
0	OK
−1	Error: INDRas.DLL not found.
−2	Error: INDRas.DLL damaged.
−3	Error: invalid number of parameters (minimum=2).
-4	Invalid value for the `numType` parameter (0 or 1).
-5	PhoneBook or Modem does not exist.
600	An operation is pending.
601	The port handle is invalid.
602	The port is already open.
603	Caller's buffer is too small.
604	Wrong information specified.
605	Cannot set port information.
606	The port is not connected
607	The event is invalid.
608	The device does not exist.
609	The device type does not exist.
610	The buffer is invalid.
611	The route is not available.
612	The route is not allocated.
613	Invalid compression specified.
614	Out of buffers.
615	The port was not found.
616	An asynchronous request is pending.
617	The port or device is already disconnecting.
618	The port is not open.
619	The port is disconnected.
620	There are no endpoints.
621	Cannot open the phone book file.
622	Cannot load the phone book file.
623	Cannot find the phone book entry.
624	Cannot write the phone book file.
625	Invalid information found in the phone book file.
626	Cannot load a string.
627	Cannot find key.
628	The port was disconnected.
629	The data link was terminated by the remote machine.
630	The port was disconnected due to hardware failure.
631	The port was disconnected by the user.
632	The structure size is incorrect.
633	The port is already in use or is not configured for Remote Access dial out.
634	Cannot register your computer on on the remote network.
635	Unknown error.
636	The wrong device is attached to the port.
637	The string could not be converted.
638	The request has timed out.
639	No asynchronous net available.
640	A NetBIOS error occurred.
641	The server cannot allocate NetBIOS resources needed to support the client.
642	One of your NetBIOS names is already registered on the remote network.
643	A network adapter at the server failed.
644	You will not receive network message pop-ups.
645	Internal authentication error.
646	The account is not permitted to log on at this time of day.
647	The account is disabled.
648	The password has expired.
649	The account does not have Remote Access permission.
650	The Remote Access server is not responding.
651	Your modem (or other connecting device) has reported an error.
652	Unrecognized response from the device.
653	A macro required by the device was not found in the device `.INF` file section.
654	A command or response in the device `.INF` file section refers to an undefined acro.
655	The <message macro was not found in the device `.INF` file secion.
656	The <defaultoff macro in the device `.INF` file section contains an undefined macro.
657	The device `.INF` file could not be opened.
658	The device name in the device `.INF` or media `.INI` file is too long.
659	The media `.INI` file refers to an unknown device name.
660	The device `.INF` file contains no responses for the command.
661	The device`.INF` file is missing a command.
662	Attempted to set a macro not listed in device `.INF` file section.
663	The media `.INI` file refers to an unknown device type.
664	Cannot allocate memory.
665	The port is not configured for Remote Access.
666	Your modem (or other connecting device) is not functioning.
667	Cannot read the media `.INI` file.
668	The connection dropped.
669	The usage parameter in the media `.INI` file is invalid.
670	Cannot read the section name from the media `.INI` file.
671	Cannot read the device type from the media `.INI` file.
672	Cannot read the device name from the media `.INI` file.
673	Cannot read the usage from the media `.INI` file.
674	Cannot read the maximum connection BPS rate from the media `.INI` file.
675	Cannot read the maximum carrier BPS rate from the media `.INI` file.
676	The line is busy.
677	A person answered instead of a modem.
678	There is no answer.
679	Cannot detect carrier.
680	There is no dial tone.
681	General error reported by device.
682	ERROR_WRITING_SECTIONNAME
683	ERROR_WRITING_DEVICETYPE
684	ERROR_WRITING_DEVICENAME
685	ERROR_WRITING_MAXCONNECTBPS
686	ERROR_WRITING_MAXCARRIERBPS
687	ERROR_WRITING_USAGE
688	ERROR_WRITING_DEFAULTOFF
689	ERROR_READING_DEFAULTOFF
690	ERROR_EMPTY_INI_FILE
691	Access denied because username and/or password is invalid on the domain.
692	Hardware failure in port or attached device.
693	ERROR_NOT_BINARY_MACRO
694	ERROR_DCB_NOT_FOUND
695	ERROR_STATE_MACHINES_NOT_STARTED
696	ERROR_STATE_MACHINES_ALREADY_STARTED
697	ERROR_PARTIAL_RESPONSE_LOOPING
698	A response keyname in the device `.INF` file is not in the expected format.
699	The device response caused buffer overflow.
700	The expanded command in the device `.INF` file is too long.
701	The device moved to a BPS rate not supported by the COM driver.
702	Device response received when none expected.
703	The Application does not allow user interaction the connection requires interaction with the user to complete successfully
704	ERROR_BAD_CALLBACK_NUMBER
705	ERROR_INVALID_AUTH_STATE
706	ERROR_WRITING_INITBPS
707	X.25 diagnostic indication.
708	The account has expired.
709	Error changing password on domain The password may be too short or may match a previously used password.
710	Serial overrun errors were detected while communicating with your modem.
711	RasMan initialization failure Check the event log.
712	Biplex port initializing Wait a few seconds and redial.
713	No active ISDN lines are available.
714	No ISDN channels are available to make the call.
715	Too many errors occurred because of poor phone line quality.
716	The Remote Access IP configuration is unusable.
717	No IP addresses are available in the static pool of Remote Access IP addresses.
718	Timed out waiting for a valid response from the remote PPP peer.
719	PPP terminated by remote machine.
720	No PPP control protocols configured.
721	Remote PPP peer is not responding.
722	The PPP packet is invalid.
723	The phone number including prefix and suffix is too long.
724	The IPX protocol cannot dial-out on the port because the machine is an IPX router.
725	The IPX protocol cannot dial-in on the port because the IPX router is not installed
726	The IPX protocol cannot be used for dial-out on more than one port at a time.
727	Cannot access `TCPCFG.DLL`.
728	Cannot find an IP adapter bound to Remote Access.
729	SLIP cannot be used unless the IP protocol is installed.
730	Computer registration is not complete.
731	The protocol is not configured.
732	The PPP negotiation is not converging.
733	The PPP control protocol for this network protocol is not available on the server.
734	The PPP link control protocol terminated.
735	The requested address was rejected by the server.
736	The remote computer terminated the control protocol.
737	Loopback detected.
738	The server did not assign an address.
739	The authentication protocol required by the remote server cannot use the Windows NT encrypted password Redial, entering the password explicitly.
740	Invalid TAPI configuration.
741	The local computer does not support the required encryption type.
742	The remote computer does not support the required encryption type.
743	The remote computer requires encryption.
744	Cannot use the IPX network number assigned by remote server Check the event log.
745	ERROR_INVALID_SMM
746	ERROR_SMM_UNINITIALIZED
747	ERROR_NO_MAC_FOR_PORT
748	ERROR_SMM_TIMEOUT
749	ERROR_BAD_PHONE_NUMBER
750	ERROR_WRONG_MODULE
751	Invalid callback number Only the characters `0` to `9`, `T`, `P`, `W`, `(`, `)`, `-`, `@`, and space are allowed in the number.
752	A syntax error was encountered while processing a script.
753	The connection could not be disconnected because it was created by the Multi-Protocol Router.

Notes

This function is not supported on Windows 7.

Examples

Tag Name	Expression
Tag	`DialError( 0, "Office DialUp" )`
Tag	`DialError( 1, "USRobotics_SportsterFaxModem", "StatusMessage", second )`
Tag	`DialError( 2, "DirectDial", "DialupError" )`

See also: FindModem()