Description
The AMSystem object contains utility functions that can be used within AutoMate™ Basic scripts. AutoMate™ automatically creates an instance of AMSystem called AutoMate™. You should not need to create additional instances of the AMSystem object within your AutoMate™ Basic scripts.
Properties
|
TaskCount |
Read Only |
Integer |
The number of currently executing AutoMate™ tasks. |
|
TaskList |
Read Only |
Variant |
A listing of the currently executing AutoMate™ tasks. Each task
is separated by a carriage-return. |
|
LastRASErrorCode |
Read Only |
Integer |
The error number resulting from the last RAS operation. This property
will contain 0 if the last RAS operation was successful. |
|
LastRASErrorText |
Read Only |
Variant |
The error text resulting from the last RAS operation. This property
will contain an empty string if the last RAS operation was successful. |
|
WindowsDir |
Read Only |
Variant |
The name and path of the Windows directory. |
|
System Dir |
Read Only |
Variant |
The name and path of the Windows System directory. |
NOTE: The TaskCount and TaskList properties are static values. Although they will accurately represent the number and names of running AutoMate™ tasks when your script begins executing, during execution, the number and names of running tasks may change. The TaskCount and TaskList properties will not be updated automatically.
Methods
Function FindWindowByTitle(Title As Variant) As Integer
Retrieves the window handle of the top-level application window with the specified title. Returns 0 if no window with the specified title exists.
Function FindWindowByClass(ClassName As Variant) As Integer
Retrieves the window handle of the top-level application window with the specified window class. Returns 0 if no window with the specified window class exists.
Function FindWindowContaining(Title, ClassName As Variant) As Integer
Retrieves the window handle of the top-level application window or associated child window that partially matches the specified window title or classname. Returns 0 if no window with the specified window title or class exists or partially matches.
Function RASConnect(ConnectTo As Variant) As Integer
Attempts to establish a remote access connection using the connection parameters in the specified phonebook entry specified by ConnectTo. If the connection is successfully established, the function returns 0. A non-zero value indicates an error, and sets the LastRASErrorCode property to the RAS Error Code (see below).
Sub RASDisconnect
RasDisconnect is now obsolete. Use RasDisconnectEX instead.
Function RASDisconnectEx(ConnectTo As Variant) As Integer
Disconnects the connection associated with the phonebook entry name specified by ConnectTo. Returns 0 if successful, and non-zero if an error occurs. A non-zero return value indicates the RAS error from the chart below.
Error Code and Error Text for RASConnect and RASDisconnect
143 Busy performing current action.
200 Can't load the RASAPI library.
201 Can't access the functions of RASAPI library. Corrupted file?'
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 port was disconnected 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 has 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 popups.
645 Internal authentication error.
646 The account is not permitted to logon 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 macro.
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 ERROR_INTERACTIVE_MODE
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 occured 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 encryption.
742 The remote server does not support encryption.
743 The remote server 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.
Related Topics: