1. Manuals
  2. Brands
  3. Symantec Manuals
  4. Software
  5. PCANYWHERE - V12.5
  6. Manual

Symantec PCANYWHERE - OLE AUTOMATION GUIDE V 12.5 Manual

Hide thumbs Also See for PCANYWHERE - OLE AUTOMATION GUIDE V 12.5:
Table of Contents

Advertisement

Quick Links

Download this manual See also: Administrator's Manual, User Manual
OLE Automation Guide

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the PCANYWHERE - OLE AUTOMATION GUIDE V 12.5 and is the answer not in the manual?

Questions and answers

Related Manuals for Symantec PCANYWHERE - OLE AUTOMATION GUIDE V 12.5

Summary of Contents for Symantec PCANYWHERE - OLE AUTOMATION GUIDE V 12.5

  • Page 1 OLE Automation Guide...
  • Page 2 Corporation or its affiliates in the U.S. and other countries. Other names may be trademarks of their respective owners. This Symantec product may contain third party software for which Symantec is required to provide attribution to the third party ( Third Party Programs”). Some of the Third Party Programs are available under open source or free software licenses.
  • Page 3 Symantec Corporation 20330 Stevens Creek Blvd. Cupertino, CA 95014 http://www.symantec.com Printed in the United States of America. 10 9 8 7 6 5 4 3 2 1...

  • Page 4: Technical Support

    The Technical Support group also creates content for our online Knowledge Base. The Technical Support group works collaboratively with the other functional areas within Symantec to answer your questions in a timely fashion. For example, the Technical Support group works with Product Engineering and Symantec Security Response to provide alerting services and virus definition updates.
  • Page 5 Troubleshooting that was performed before contacting Symantec Recent software configuration changes and network changes Licensing and registration If your Symantec product requires registration or a license key, access our technical support Web page at the following URL: www.symantec.com/techsupp/ Customer service Customer service information is available at the following URL: www.symantec.com/techsupp/...
  • Page 6 North America and Latin America supportsolutions@symantec.com Additional enterprise services Symantec offers a comprehensive set of services that allow you to maximize your investment in Symantec products and to develop your knowledge, expertise, and global insight, which enable you to manage your business risks proactively.

  • Page 7: Table Of Contents

    Contents Technical Support ....................4 Chapter 1 Using OLE Automation with Symantec pcAnywhere ..............9 About OLE Automation ..............9 About the pcAnywhere Automation Server ........10 What you can do with the pcAnywhere Automation Server ....10 Before you start ................11 Automatically registering the remote engine .......
  • Page 8 Contents COM device properties ............42 NetBIOS device properties ............45 ISDN via CAPI 2.0 device properties ........... 46 CHostDataEx object ..............47 Visual Basic sample code for host functionality ......54 Awrem32 functions ..............55 Chapter 3 Visual C++ object definitions ...........

  • Page 9: Using Ole Automation With Symantec Pcanywhere

    Chapter Using OLE Automation with Symantec pcAnywhere This chapter includes the following topics: About OLE Automation About the pcAnywhere Automation Server What you can do with the pcAnywhere Automation Server Before you start Where to find more information About OLE Automation...

  • Page 10: About The Pcanywhere Automation Server

    The pcAnywhere Automation Server functions as a programmable replacement for the Symantec pcAnywhere user interface and mirrors much of its default behavior. For example, when you create a host object in pcAnywhere, the first available modem TAPI device is assigned by default.

  • Page 11: Before You Start

    Automation Server and its interfaces. You can register the GUID entries automatically if you are running the external application on a computer on which Symantec pcAnywhere is installed. Otherwise, you must register the GUID entries manually. Automatically registering the remote engine”...

  • Page 12: Accessing The Pcanywhere Automation Server

    Using OLE Automation with Symantec pcAnywhere Before you start pcAnywhere Automation Server executable file (Winawsvr.exe). You only need to run the executable file once to add the GUIDs to the registry. The Winawsvr.exe file is located in the installation directory.

  • Page 13: Accessing The Pcanywhere Automation Server With Visual C

    Using OLE Automation with Symantec pcAnywhere Before you start Create, retrieve, or delete a data object file. After a data object is created or retrieved, you can get or set properties of the object. The Visual Basic syntax does not use a property’s name to differentiate between getting and setting its value.
  • Page 14 Using OLE Automation with Symantec pcAnywhere Before you start Winawsvr.tlb Provides the information needed to connect to the pcAnywhere Automation Server and access its interfaces Awrem32.tlb Provides the information needed to control pcAnywhere connections The following procedures explain how to import the class definitions from the pcAnywhere Automation Server type libraries into your MFC application and then view the classes that have been added to your application.

  • Page 15: Launching Host And Remote Ole Objects

    In the Workspace window, click the FileView tab. Launching host and remote OLE objects Symantec pcAnywhere requires that you store all host and remote objects in the default data directory. Before you launch a host or remote object that you created using OLE, ensure that the object is located in the pcAnywhere default data directory.
  • Page 16 Using OLE Automation with Symantec pcAnywhere Where to find more information...

  • Page 17: Visual Basic Object Definitions

    Chapter Visual Basic object definitions This chapter includes the following topics: About Visual Basic objects CRemoteDataManager methods CRemoteData properties CRemoteDataEx object CHostDataManager methods CHostData properties CHostDataEx object Awrem32 functions About Visual Basic objects The pcAnywhere Automation Server provides the following components to support OLE Automation: Winawsvr Provides the information needed to connect to the pcAnywhere...

  • Page 18: Cremotedatamanager Methods

    Visual Basic object definitions CRemoteDataManager methods Winawsvr objects Table 2-1 Object Description Reference CRemoteDataManager Provides the methods for creating, opening, CRemoteDataManager methods” modifying, saving, and deleting on page 18. CRemoteData objects CRemoteData Defines the parameters for accessing and CRemoteData properties” on page 21.
  • Page 19 Visual Basic object definitions CRemoteDataManager methods CRemoteDataManager methods (continued) Table 2-2 CRemoteDataManager Parameter or return Description method value FindFirst(Pattern) Parameter = Pattern as Finds the first pcAnywhere remote string object file (*.chf) in the current directory; file name pattern filters based on the specified file name pattern (an asterisk [*] finds all files in the current directory)
  • Page 20 Visual Basic object definitions CRemoteDataManager methods CRemoteDataManager methods (continued) Table 2-2 CRemoteDataManager Parameter or return Description method value RetrieveObjectEx(AccessMode) Parameter = Specifies how this object is to be AccessMode as integer used. This relates to the password protection The options are as follows: 0 = Not specified 1 = View only 2 = View and Modify...

  • Page 21: Cremotedata Properties

    Visual Basic object definitions CRemoteData properties CRemoteData properties The properties and parameters that are available for the CRemoteData object are shown as follows. Table 2-3, replace the information in angle brackets with the actual values. CRemoteData properties and parameters Table 2-3 Property Parameter Description...
  • Page 22 Visual Basic object definitions CRemoteData properties CRemoteData properties and parameters (continued) Table 2-3 Property Parameter Description <CRemoteData>.ReadProtection(Bool) Bool Sets the requirement of a password to view the properties of the remote object. Set by Password. <CRemoteData>.WriteProtection(Bool) Bool Sets the requirement of a password to save changes to the remote object.

  • Page 23: Connection Type Properties

    Visual Basic object definitions CRemoteData properties CRemoteData properties and return values (continued) Table 2-4 Property Return value Description Integer = <CRemoteData>.RedialDelay Integer Returns the number of seconds between redial attempts String = <CRemoteData>.AutoLoginName String Returns the login name that is used for automatic logins Bool = <CRemoteData>.ExecuteProtection Bool...
  • Page 24 Visual Basic object definitions CRemoteData properties Connection type properties and parameters Table 2-5 Property Parameter Description <CRemoteData>.ConnectionType(String) String Sets the connection type of the remote. The value that is passed in must be a valid connection type as defined by the FirstConnectionType() and NextConnectionType() functions.

  • Page 25: Dialing Properties

    Visual Basic object definitions CRemoteData properties Connection type properties and return values (continued) Table 2-6 Property Return value Description Integer = <CRemoteData>.ConnectionType Integer Returns the number of available connection types. The following are examples of valid connection types: COM1 COM2 COM3 COM4 TCP/IP...

  • Page 26: Com Device Properties

    Visual Basic object definitions CRemoteData properties Properties and parameters for dialing properties (continued) Table 2-7 Property Parameter Description <CRemoteData>.CountryCode(String) String Sets the country code dialing properties for modem connections The following table defines the properties and return values for modem dialing properties.
  • Page 27 Visual Basic object definitions CRemoteData properties COM device properties and parameters Table 2-9 Property Parameter Description <CRemoteData>.ComParity(String) String Sets the communications parity The following values are valid: <None> Even Mark Space <CRemoteData>.ComFlowControl(String) String Sets the flow control of COM-based connection types The following values are valid: <None>...
  • Page 28 Visual Basic object definitions CRemoteData properties COM device properties and parameters (continued) Table 2-9 Property Parameter Description <CRemoteData>.ComSpeed(Long) Long Contains the maximum COM speed setting The following values are valid: 1200 2400 4800 9600 38400 57600 115200 The following table describes the COM device properties and return values. Table 2-10, replace the information in angle brackets with the actual values.

  • Page 29: Netbios Device Properties

    Visual Basic object definitions CRemoteData properties COM device properties and return values (continued) Table 2-10 Property Return value Description String = <CRemoteData>.ComStartedBy String Returns the Com Start control of COM-based connection types The following values are valid: Always connected Carrier detect (DCD) Clear to send (CTS) Data set ready (DSR) Ring indicator (RI)

  • Page 30: Isdn Via Capi 2.0 Device Properties

    Visual Basic object definitions CRemoteData properties Table 2-11, replace the information in angle brackets with the actual values. NetBIOS property and parameter Table 2-11 Property Parameter Description <CRemoteData>.LanaNumber(Integer) Integer Sets the LAN Adapter (LANA) number for NetBIOS connections The following table defines the NetBIOS property and return value. Table 2-12, replace the information in angle brackets with the actual values.

  • Page 31: Cremotedataex Object

    Visual Basic object definitions CRemoteDataEx object ISDN via CAPI 2.0 properties and return values (continued) Table 2-14 Property Return value Description String = <CRemoteData>.CapiExtensions String Returns the current list of CAPI extensions from the remote object CRemoteDataEx object The CRemoteDataEx object contains the same functionality as the CRemoteData object with some additional functionality.

  • Page 32: Visual Basic Sample Code For Remote Functionality

    Visual Basic object definitions CRemoteDataEx object CRemoteDataEx properties and return values Table 2-16 Property Return value Description String = <CRemoteData>.PrivateKey String Returns the name of the currently active private key container. String = <CRemoteData>.CertificateName String Returns the common name of the active private key container.
  • Page 33 Visual Basic object definitions CRemoteDataEx object 'retrieve remote data object Set RemoteData = RemoteDataManager.RetrieveObjectEx("pod.CHF", 2, 0) 'display some properties s = RemoteData.AreaCode() MsgBox (s) s = RemoteData.PhoneNumber() MsgBox (s) 'set some properties RemoteData.AreaCode = "212" RemoteData.PhoneNumber = "555-5555" 'write object to disk RemoteData.WriteObject (0) End Sub Use the FindFirst and FindNext methods to display the remote file in a directory...

  • Page 34: Chostdatamanager Methods

    Visual Basic object definitions CHostDataManager methods Create a remote object. Set the connection type to TCP/IP and the computer name "Host1," and then launch it as follows: Private Sub Command6_Click() Dim RemoteDataManager as Object Dim RemoteData as Object Dim s as string Set RemoteDataManager = CreateObject("WINAWSVR.REMOTEDATAMANAGER") MsgBox (RemoteDataManager.CurrentDirectory())
  • Page 35 Visual Basic object definitions CHostDataManager methods CHostDataManager Parameter or Description method return value FindFirst Return value = TRUE if a host object file matching the Boolean specified pattern is found. The full path name of the matching file is stored in Name FindNext(Name) Parameter = Return buffer for the full path name of the...

  • Page 36: Chostdata Properties

    Visual Basic object definitions CHostData properties CHostDataManager Parameter or Description method return value RetrieveObjectEx(Password) Parameter = Object password. May be NULL Password as string RetrieveObjectEx Return value = CHostDataEx object from the specified file Object CreateObject(Name) Parameter = Creates a CHostData object and returns an Name as string LPDISPATCH pointer to it.
  • Page 37 Visual Basic object definitions CHostData properties Table 2-17, replace the information in angle brackets with the actual values. CHostData properties and parameters Table 2-17 Property Parameter Description <CHostData>.PhoneNumber(String) String Sets the phone number of the host computer. <CHostData>.UseDialingProperties(Bool) Bool Sets the system dialing properties. <CHostData>.RedialCount(Integer) Integer Sets the number of redial attempts before...

  • Page 38: Connection Type Properties

    Visual Basic object definitions CHostData properties The following table describes the CHostData properties and return values. Table 2-18, replace the information in angle brackets with the actual values. CHostData properties and return values Table 2-18 Property Return value Description String = <CHostData>.PhoneNumber String Returns the phone number of the host computer...
  • Page 39 Visual Basic object definitions CHostData properties Connection type properties and parameters Table 2-19 Property Parameter Description <CHostData>.ConnectionType(String) String Sets the connection type of the host. The value that is passed in must be a valid connection type as defined by the FirstConnectionType() and NextConnectionType() functions.
  • Page 40 Visual Basic object definitions CHostData properties Connection type properties and return values (continued) Table 2-20 Property Return value Description Integer = <CHostData>.ConnectionType Integer Returns the number of available connection types. The following are examples of valid connection types: COM1 COM2 COM3 COM4 TCP/IP...

  • Page 41: Assignconnection(Connectiontype) Method

    Visual Basic object definitions CHostData properties AssignConnection(ConnectionType) method The AssignConnection(Connection Type) method places the requested connection type on the host object’s list of assigned connection types and makes it the current connection type when processing subsequent device-specific method calls. If the requested connection type is already on the list of assigned connections, the list of assigned connections does not change.

  • Page 42: Dialing Properties

    Visual Basic object definitions CHostData properties The following table defines the UnassignConnection return value: Return value Description Boolean TRUE if this device type is successfully unassigned Dialing properties The following table defines the properties and return values for setting the dialing properties for modem connections.
  • Page 43 Visual Basic object definitions CHostData properties Table 2-23, replace the information in angle brackets with the actual values. COM device properties and parameters Table 2-23 Property Parameter Description <CHostData>.ComParity(String) String Sets the communications parity The following values are valid: <None> Even Mark Space...
  • Page 44 Visual Basic object definitions CHostData properties COM device properties and parameters (continued) Table 2-23 Property Parameter Description <CHostData>.ComSpeed(Long) Long Sets the maximum COM speed setting The following values are valid: 1200 2400 4800 9600 38400 57600 115200 The following table describes the COM device properties and return values. Table 2-24, replace the information in angle brackets with the actual values.

  • Page 45: Netbios Device Properties

    Visual Basic object definitions CHostData properties COM device properties and return values (continued) Table 2-24 Property Return value Description String = <CHostData>.ComStartedBy String Returns the Com Start control of COM-based connection types The following values are valid: Always connected Carrier detect (DCD) Clear to send (CTS) Data set ready (DSR) Ring indicator (RI)

  • Page 46: Isdn Via Capi 2.0 Device Properties

    Visual Basic object definitions CHostData properties Table 2-25, replace the information in angle brackets with the actual values. NetBIOS property and parameter Table 2-25 Property Parameter Description <CHostData>.LanaNumber(Integer) Integer Sets the LAN Adapter (LANA) number for NetBIOS connections The following table defines the property and return value for NetBIOS network devices.

  • Page 47: Chostdataex Object

    Visual Basic object definitions CHostDataEx object ISDN via CAPI 2.0 properties and return values (continued) Table 2-28 Property Return value Description String = <CHostData>.CapiExtensions String Returns the current list of CAPI extensions from the host object CHostDataEx object The CHostDataEx object contains the same functionality as the CHostData object with some additional functionality.
  • Page 48 Visual Basic object definitions CHostDataEx object CHostDataEx properties and parameters (continued) Table 2-29 Property Parameter Description <CHostData>.ConfirmDeny(Bool) Bool Defines whether the connection should be ended if the prompt to confirm the connection time limit expires. <CHostData>.PwCaseSensitive(Bool) Bool Forces the use of case-sensitive passwords. <CHostData>.PwAttempts(Byte) Byte Sets the number of consecutive failed logon...
  • Page 49 Visual Basic object definitions CHostDataEx object CHostDataEx properties and parameters (continued) Table 2-29 Property Parameter Description <CHostData>.EnableConnLostSecurity(Bool) Bool Activates or deactivates the end of session security options for sessions that end abnormally. <CHostData>.AuthenticationType(Byte) Byte Sets the authentication type. The following values are valid: 0: pcAnywhere 1: pcAnywhere 2: Windows...
  • Page 50 Visual Basic object definitions CHostDataEx object CHostDataEx properties and parameters (continued) Table 2-29 Property Parameter Description <CHostData>.EnableEndSessSecurity(Bool) Bool Activates or deactivates the security options for a normal end of session. <CHostData>.EndSessSecurity(Byte) Byte Sets the security options for a normal end of session.
  • Page 51 Visual Basic object definitions CHostDataEx object CHostDataEx properties and return values (continued) Table 2-30 Property Return value Description Byte = <CHostDataEx>.CryptReqLevel Byte Returns one of the following encryption settings: -1: None 0: pcAnywhere 1: Symmetric 2: Public key Bool = <CHostDataEx>.CryptRefuseLower Bool Returns the value of the deny lower encryption setting.
  • Page 52 Visual Basic object definitions CHostDataEx object CHostDataEx properties and return values (continued) Table 2-30 Property Return value Description Bool = <CHostDataEx>.MinimizeOnLaunch Bool Returns the run minimized on host startup setting. Bool = <CHostDataEx>.RunAsService Bool Returns the run host as a service setting. Byte = <CHostDataEx>.ConnLostWait Byte Returns the number of minutes to wait before...
  • Page 53 Visual Basic object definitions CHostDataEx object CHostDataEx properties and return values (continued) Table 2-30 Property Return value Description Byte = <CHostDataEx>.ConnLostSecurity Byte Returns the numeric representation of the security level that is set for handling an abnormal end of session. The following values are valid: 1: Log off user 2: Restart host computer...

  • Page 54: Visual Basic Sample Code For Host Functionality

    Visual Basic object definitions CHostDataEx object CHostDataEx properties and return values (continued) Table 2-30 Property Return value Description Bool = <CHostDataEx>.AllowDriveSecurity Bool Returns whether the drive security option is enabled. Bool = <CHostDataEx>.UseDirectoryServices Bool Returns whether the directory services option is enabled.

  • Page 55: Awrem32 Functions

    Visual Basic object definitions Awrem32 functions RemoteData. HostData = "212" RemoteData. HostData = "555-5555" 'write object to disk HostData.WriteObject (0) End Sub Use the FindFirst and FindNext methods to display the host file in a directory as follows: Private Sub Command5_Click() Dim HostDataManager as Object Dim HostData as Object Dim s as string...
  • Page 56 Visual Basic object definitions Awrem32 functions Awrem32 function Parameter or Description return value awDisconnect() Return value = After calling this function, the calling Boolean program must delete the object (C++ - delete IAwrem32X*, VB - set ObjectName = Nothing;) FileXferFromHost(HostFile) Parameter = Contains the fully qualified path and file HostFile as...
  • Page 57 Visual Basic object definitions Awrem32 functions Awrem32 function Parameter or Description return value ExecuteHostFile Return value = TRUE if command executed Boolean GetError() Return value = Returns the last error generated in String Awrem32 ConnectionStatus() Return value = Returns the current status of your Short connection to the host computer The possible values include the following:...
  • Page 58 Visual Basic object definitions Awrem32 functions...

  • Page 59: Visual C++ Object Definitions

    Chapter Visual C++ object definitions This chapter includes the following topics: About Visual C++ objects CRemoteDataManager methods CRemoteData object CRemoteDataEx object CHostDataManager methods CHostData object CHostDataEx object Awrem32 functions About Visual C++ objects The pcAnywhere Automation Server provides the following components to support OLE Automation: Winawsvr Provides the information needed to connect to the pcAnywhere...

  • Page 60: Cremotedatamanager Methods

    Visual C++ object definitions CRemoteDataManager methods Winawsvr objects Table 3-1 Object Description Reference CRemoteDataManager Provides the methods for creating, opening, CRemoteDataManager methods” modifying, saving, and deleting on page 60. CRemoteData objects CRemoteData Defines the parameters for accessing and CRemoteData object” on page 63.
  • Page 61 Visual C++ object definitions CRemoteDataManager methods Method Parameter or Description return value BOOL FindFirst(LPCTSTR Parameter = File name pattern to filter object files (an lpszPattern, BSTR FAR*); LPCTSTR asterisk [*] finds all files in the current lpszPattern directory) BOOL Parameter = Return buffer for the full path name of FindFirst(pbstrFullQualName);...
  • Page 62 Visual C++ object definitions CRemoteDataManager methods Method Parameter or Description return value LPDISPATCH Parameter = Retrieves a CRemoteDataEx object by RetrieveObjectEx(LPCTSTR LPCTSTR file name lpszFQName); lpszFQName Parameter is the fully qualified remote object file name to be loaded LPDISPATCH Parameter = Specifies how this object is to be used.

  • Page 63: Cremotedata Object

    Visual C++ object definitions CRemoteData object Method Parameter or Description return value LPDISPATCH Parameter = Creates a CRemoteDataEx object and CreateObjectEx(LPCTSTR LPCTSTR returns an LPDISPATCH pointer to it lpszFQName); lpszFQName Parameter is the fully qualified remote Return value = object file name for the new object LPDISPATCH Return value is a pointer to an OLE dispatch object.
  • Page 64 Visual C++ object definitions CRemoteData object BSTR GetComputerName(); void SetComputerName(LPCTSTR lpszNewValue); The phone number is the number to dial to establish a modem connection to a pcAnywhere host computer. BSTR GetPhoneNumber(); void SetPhoneNumber(LPCTSTR lpszNewValue); Indicates whether TAPI dialing properties should be used (location information) (TRUE) or whether the phone number string should be used exactly as it appears (FALSE).
  • Page 65 Visual C++ object definitions CRemoteData object The password for this object. BSTR GetPassword(); void SetPassword(LPCTSTR lpszNewValue); The object can only be launched if the password is used (TRUE). BOOL GetExecuteProtection(); void SetExecuteProtection(BOOL bNewValue); The object can only be viewed if the correct password is provided (TRUE). BOOL GetReadProtection();...

  • Page 66: Remote Object Detail Methods

    Visual C++ object definitions CRemoteData object NetBIOS DEFAULT TAPI TCP/IP The name of a TAPI device can also be used as a connection type. DEFAULT TAPI uses the first TAPI device found on the system. To use a specific TAPI device, use FirstConnectionType() / NextConnectionType() to search for available devices.
  • Page 67 Visual C++ object definitions CRemoteData object XONXOFF RTS/CTS BOTH Sets the connection start setting. BSTR GetComStartedBy(); void SetComStartedBy(LPCTSTR lpszNewValue); Connection start values are as follows: Always connected Carrier detect (DCD) Clear to send (CTS) Data set ready (DSR) Ring indicator (RI) Receive 2 <CR>'s Modem response Sets the connection end values.

  • Page 68: Remote Object Methods

    Visual C++ object definitions CRemoteData object 1200 2400 4800 9600 19200 38400 57600 115200 NetBIOS device details Sets the LAN Adapter (LANA) number to use for this connection. short GetLanaNumber(); void SetLanaNumber(short nNewValue); ISDN via CAPI 2.0 device details Activates channel bonding (uses two ISDN channels for one connection) if TRUE. BOOL GetCapiChannelBonding();...
  • Page 69 Visual C++ object definitions CRemoteData object Method Parameter or Description return value BSTR Return value = FirstConnectionType() and FirstConnectionType(); and BSTR NextConnectionType() are used to iterate BSTR through the available connection types. NextConnectionType(); These functions return a BSTR, which is the name of an available connection type.

  • Page 70: Cremotedataex Object

    Visual C++ object definitions CRemoteDataEx object CRemoteDataEx object The CRemoteDataEx object contains the same functionality as the CRemoteData object with the following additional Get and Set methods: BSTR GetPrivateKey(); //Returns the PrivateKey information void SetPrivateKey(LPCTSTR lpszNewValue); BSTR GetCertificationName(); //Returns the Certification Name void SetCertificationName(LPCTSTR lpszNewValue);...

  • Page 71: Chostdatamanager Methods

    Visual C++ object definitions CHostDataManager methods // Save the object data if (remoteData.WriteObject(0)) // And launch it if (remoteData.Launch()) bReturn = TRUE; // Release the remote object. remoteData.ReleaseDispatch(); remoteDM.ReleaseDispatch( _T( "WINAWSVR.RemoteDataManager") ); return bReturn; CHostDataManager methods The following table describes the CHostDataManager methods, including the parameters and return values for accessing and controlling CHostData objects: Method Parameter or...
  • Page 72 Visual C++ object definitions CHostDataManager methods Method Parameter or Description return value BOOL FindFirst(LPCTSTR Parameter = Finds the first pcAnywhere host object lpszPattern); LPCTSTR file (*.bhf) in the current directory, lpszPattern based on the specified file name pattern Return value = The parameter is the File name pattern BOOL to filter object files (an asterisk [*] finds...
  • Page 73 Visual C++ object definitions CHostDataManager methods Method Parameter or Description return value LPDISPATCH Parameter = short Specifies how this object is to be used. RetrieveObject(short wAccessMode This relates to the password protection. wAccessMode); The options are as follows: 0 = Not specified 1 = View only 2 = View and Modify 3 = Execute...
  • Page 74 Visual C++ object definitions CHostDataManager methods Method Parameter or Description return value LPDISPATCH Parameter = Creates a CHostData object and returns CreateObject(LPCTSTR LPCTSTR an LPDISPATCH pointer to it lpszName); lpszFQName The parameter is the fully qualified host Return value = object file name for the new object LPDISPATCH The return value is a pointer to an OLE...

  • Page 75: Chostdata Object

    Visual C++ object definitions CHostData object CHostData object Use this object to modify host object data. Get and Set methods The following methods are used to get and set properties of the CHostData object. The phone number is the number to dial to establish a modem connection to a pcAnywhere remote computer.

  • Page 76: Host Object Detail Methods

    Visual C++ object definitions CHostData object BOOL GetRecordSession(); void SetRecordSession(BOOL bNewValue); The name of the record file for sessions using this object. BSTR GetRecordFile(); void SetRecordFile(LPCTSTR lpszNewValue); Host object Detail methods When a host object is assigned a connection type, the device details are set to valid default values.
  • Page 77 Visual C++ object definitions CHostData object COM2 COM3 COM4 NetBIOS TCP/IP ISDN via CAPI 2.0 DEFAULT TAPI The name of a TAPI device can also be used as a connection type. DEFAULT TAPI uses the first TAPI device found in the system. To use a specific TAPI device, use FirstConnectionType() and NextConnectionType() to search for available devices.
  • Page 78 Visual C++ object definitions CHostData object BOTH The following code sets the connection start values: BSTR GetComStartedBy(); void SetComStartedBy(LPCTSTR lpszNewValue); Connection start values are as follows: Always connected Carrier detect (DCD) Clear to send (CTS) Data set ready (DSR) Ring indicator (RI) Receive 2 <CR>'s Modem response The following code sets the connection end values:...
  • Page 79 Visual C++ object definitions CHostData object 4800 9600 19200 38400 57600 115200 NetBIOS device details Sets the LAN Adapter (LANA) number to use for this connection. short GetLanaNumber();void SetLanaNumber(short nNewValue); NASI/NCSI device details Sets the user name for the NASI server. BSTR GetNasiUserName();...

  • Page 80: Host Object Methods

    Visual C++ object definitions CHostData object BOOL NasiPort(); BSTR GetNasiPortName(); void SetNasiPortName(LPCTSTR lpszNewValue); BOOL GetNasiSelectOnConnect(); void SetNasiSelectOnConnect(BOOL bNewValue); ISDN via CAPI 2.0 device details Activates channel bonding (uses two ISDN channels for one connection) if TRUE. BOOL GetCapiChannelBonding(); void SetCapiChannelBonding(BOOL bNewValue); Sets any additional CAPI extensions that are needed for communications.
  • Page 81 Visual C++ object definitions CHostData object Method Parameter or Description return value short Return value = Returns the maximum number of MaxAssignedConnections() Short connection types that can be assigned at the same time (currently two) short Return value = Returns the number of assigned AssignedConnections() Short connection types.

  • Page 82: Chostdataex Object

    Visual C++ object definitions CHostDataEx object Method Parameter or Description return value BOOL Parameter = Writes the object data out to the host WriteObject(LPCTSTR LPCTSTR object file lpszPassword); lpszPassword The parameter is the object password Return value = The return value is TRUE if object is BOOL successfully written CHostDataEx object...
  • Page 83 Visual C++ object definitions CHostDataEx object short GetAuthenticationType(); void SetAuthenticationType(short nNewValue); BOOL GetLockSystemWhileWait(); void SetLockSystemWhileWait(BOOL bNewValue); BOOL GetMinimizeOnLaunch(); void SetMinimizeOnLaunch(BOOL bNewValue); BOOL GetRunAsService(); void SetRunAsService(BOOL bNewValue); short GetConnLostWait(); void SetConnLostWait(short nNewValue); BOOL GetConnLostHostOpts(); void SetConnLostHostOpts(BOOL bNewValue); BOOL GetEnableConnLostSecurity(); void SetEnableConnLostSecurity(BOOL bNewValue); short GetConnLostSecurity();...

  • Page 84: Visual C++ Sample Code For Host Functionality

    Visual C++ object definitions CHostDataEx object Visual C++ sample code for host functionality The following sample Visual C++ function creates a host object, sets its connection type to TCP/IP, sets the computer name to the TCP/IP address that is passed into the function, and then launches the host object: BOOL LaunchTCPHost(LPCTSTR lpszAddress) BOOL bReturn = FALSE;...

  • Page 85: Awrem32 Functions

    Visual C++ object definitions Awrem32 functions Awrem32 functions The following table describes the Awrem32 functions, including the parameters and return values for handling connections between a host and remote computer: Method Parameter or Description return value boolean awConnect(BSTR Parameter = Name Creates the connection to the host FileName);...
  • Page 86 Visual C++ object definitions Awrem32 functions Method Parameter or Description return value boolean Parameter = Copies a file from the remote computer FileXferToHost(BSTR HostFile as string to the host computer. The parameters HostFile); can contain wildcard characters The parameter contains the fully qualified destination path and file name.
  • Page 87 Visual C++ object definitions Awrem32 functions Method Parameter or Description return value boolean Parameter Executes an existing file on the host ExecuteHostFile(BSTR =FileName as computer. This function only executes FileName); string batch, command, and executable files. It does not execute files that are Return value = associated with executables.
  • Page 88 Visual C++ object definitions Awrem32 functions...

  • Page 89: Index

    Index connections (continued) returning status 57, 87 API libraries 13 starting 36, 55, 63, 85 automation controllers country codes about Visual Basic 12 on host 81 about Visual C++ 13 on remote 69 automation server.. See pcAnywhere Automation CRemoteData Server using Visual Basic 21 Awrem32 using Visual C++ 63...
  • Page 90 Index host objects parity 27, 43, 66, 77 creating 74 passwords deleting 36, 74 on host objects 81 device details 76 on remote objects 69 dialing properties 42 pcAnywhere Automation Server directories 34, 71 about 10 finding 35–36, 72–73 accessing with Visual Basic 12 methods 80 accessing with Visual C++ 13 passwords 81...
  • Page 91 Index Visual Basic (continued) CRemoteDataManager object 18 Visual C++ accessing pcAnywhere Automation Server 13 Awrem32 functions 85 CHostData object 75 CHostDataEx object 82 CHostDataManager object 71 code samples 70, 84 CRemoteData object 63 CRemoteDataEx object 70 CRemoteDataManager object 60 importing classes 14 including Winawsvr.h 15 Winawsvr executable 12...

This manual is also suitable for:

Ole automation

Table of Contents