DialError
Returns the error codes regarding each connection.
| Function | Group | Execution | Windows | Embedded | Thin Client | Mobile Access |
|---|---|---|---|---|---|---|
| DialError | Dial-up | Synchronous | Supported (see note) | Supported | Supported | Not 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 should be enclosed in quotes, as shown in the syntax diagram, or else the function will try to use the value of the 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()