Symantec PCANYWHERE - OLE AUTOMATION GUIDE V12.1 User manual

Symantec pcAnywhere™

OLE Automation Guide

Symantec pcAnywhere™ OLE Automation Guide

The software described in this book is furnished under a license agreement and may be

used only in accordance with the terms of the agreement.

Documentation version 12.1

Legal Notice

Federal acquisitions: Commercial Software - Government Users Subject to Standard

License Terms and Conditions.

Symantec, the Symantec Logo, and pcAnywhere are trademarks or registered trademarks

of Symantec Corporation in the United States and certain other countries. Other names

may be trademarks of their respective owners.

Microsoft, Windows, Windows NT, MS-DOS, and the Windows logo are registered

trademarks or trademarks of Microsoft Corporation.

Additional company and product names may be trademarks or registered trademarks of

the individual companies and are respectfully acknowledged.

The product described in this document is distributed under licenses restricting its use,

copying, distribution, and decompilation/reverse engineering. No part of this document

may be reproduced in any form by any means without prior written authorization of

Symantec Corporation and its licensors, if any.

THIS DOCUMENTATION IS PROVIDED “AS IS” AND ALL EXPRESS OR IMPLIED

CONDITIONS, REPRESENTATIONS AND WARRANTIES, INCLUDING ANY IMPLIED

WARRANTY OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NON-

INFRINGEMENT, ARE DISCLAIMED, EXCEPT TO THE EXTENT THAT SUCH

DISCLAIMERS ARE HELD TO BE LEGALLY INVALID, SYMANTEC CORPORATION SHALL

NOT BE LIABLE FOR INCIDENTAL OR CONSEQUENTIAL DAMAGES IN CONNECTION

WITH THE FURNISHING PERFORMANCE, OR USE OF THIS DOCUMENTATION. THE

INFORMATION CONTAINED IN THIS DOCUMENTATION IS SUBJECT TO CHANGE

WITHOUT NOTICE.

Symantec Corporation

20330 Stevens Creek Blvd.

Cupertino, CA 95014 USA

http://www.symantec.com

Printed in the United States of America.

10987654321

Technical Support

Symantec Technical Support maintains support centers globally. Technical

Support’s primary role is to respond to specific queries about product feature

and function, installation, and configuration. The Technical Support group also

authors 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.

Symantec’s maintenance offerings include the following:

■A range of support options that give you the flexibility to select the right

amount of service for any size organization

■Telephone and Web-based support that provides rapid response and up-to-

the-minute information

■Upgrade insurance that delivers automatic software upgrade protection

■Global support that is available 24 hours a day, 7 days a week worldwide.

Support is provided in a variety of languages for those customers that are

enrolled in the Platinum Support program

■Advanced features, including Technical Account Management

For information about Symantec’s Maintenance Programs, you can visit our

Web site at the following URL:

www.symantec.com/techsupp/ent/enterprise.html

Select your country or language under Global Support. The specific features that

are available may vary based on the level of maintenance that was purchased

and the specific product that you use.

Contacting Technical Support

Customers with a current maintenance agreement may access Technical

Support information at the following URL:

www.symantec.com/techsupp/ent/enterprise.html

Select your region or language under Global Support.

Before contacting Technical Support, make sure you have satisfied the system

requirements that are listed in your product documentation. Also, you should be

at the computer on which the problem occurred, in case it is necessary to

recreate the problem.

When you contact Technical Support, please have the following information

available:

■Product release level

■Hardware information

■Available memory, disk space, NIC information

■Operating system

■Version and patch level

■Network topology

■Router, gateway, and IP address information

■Problem description:

■Error messages and log files

■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/ent/enterprise.html.

Select your region or language under Global Support, and then select the

Licensing and Registration page.

Customer service

Customer service information is available at the following URL:

www.symantec.com/techsupp/ent/enterprise.html

Select your country or language under Global Support.

Customer Service is available to assist with the following types of issues:

■Questions regarding product licensing or serialization

■Product registration updates such as address or name changes

■General product information (features, language availability, local dealers)

■Latest information about product updates and upgrades

■Information about upgrade insurance and maintenance contracts

■Information about Symantec Value License Program

■Advice about Symantec's technical support options

■Nontechnical presales questions

■Issues that are related to CD-ROMs or manuals

Maintenance agreement resources

If you want to contact Symantec regarding an existing maintenance agreement,

please contact the maintenance agreement administration team for your region

as follows:

■Asia-Pacific and Japan: contr[email protected]om

■Europe, Middle-East, and Africa: semea@symantec.com

■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. Additional services that are available include the following:

To access more information about Enterprise Services, please visit our Web site

at the following URL:

www.symantec.com

Select your country or language from the site index.

Symantec Early Warning

Solutions

These solutions provide early warning of cyber attacks,

comprehensive threat analysis, and countermeasures to

prevent attacks before they occur.

Managed Security

Services

These services remove the burden of managing and monitoring

security devices and events, ensuring rapid response to real

threats.

Consulting services Symantec Consulting Services provide on-site technical

expertise from Symantec and its trusted partners. Symantec

Consulting Services offer a variety of prepackaged and

customizable options that include assessment, design,

implementation, monitoring and management capabilities,

each focused on establishing and maintaining the integrity and

availability of your IT resources.

Educational Services These services provide a full array of technical training,

security education, security certification, and awareness

communication programs.

Contents

Chapter 1 Using OLE Automation with Symantec pcAnywhere

About OLE Automation ....................................................................................... 11

About the pcAnywhere Automation Server .................................................... 12

What you can do with the pcAnywhere Automation Server ........................ 12

Before you start .................................................................................................... 13

Automatically registering the remote engine ......................................... 13

Manually registering the remote engine .................................................. 14

Accessing the pcAnywhere Automation Server ..................................... 14

Accessing the pcAnywhere Automation Server with Visual Basic ...... 14

Accessing the pcAnywhere Automation Server with Visual C++ ........ 15

Launching host and remote OLE objects .................................................. 17

Where to find more information ....................................................................... 17

Chapter 2 Visual Basic object definitions

About Visual Basic objects .................................................................................. 19

CRemoteDataManager methods ........................................................................ 20

CurrentDirectory() ....................................................................................... 20

ChangeDirectory(NewDirectory) ............................................................... 21

FindFirst(Pattern, Name string) ................................................................ 21

FindNext(Name) ........................................................................................... 22

RetrieveObject(Name, AccessMode, Password) ......................................23

RetrieveObjectEx(Name, AccessMode, Password) ..................................23

CreateObject(Name) ..................................................................................... 24

CreateObjectEx(Name) ................................................................................ 24

DeleteObject(Name, Password) .................................................................. 25

CRemoteData properties .................................................................................... 26

Connection type properties ........................................................................ 28

Dialing properties ........................................................................................ 30

COM device properties ................................................................................ 31

NetBIOS device properties ......................................................................... 34

ISDN via CAPI 2.0 device properties ......................................................... 35

CRemoteDataEx object ........................................................................................ 36

Visual Basic sample code for remote functionality ................................ 37

8Contents

CHostDataManager methods ............................................................................. 39

CurrentDirectory() ....................................................................................... 39

FindFirst(Pattern, Name string) ................................................................ 39

FindNext(Name) ........................................................................................... 40

RetrieveObject(Name, AccessMode, Password) ...................................... 41

RetrieveObjectEx(Name, AccessMode, Password) .................................. 41

CreateObject(Name) ..................................................................................... 42

CreateObjectEx(Name) ................................................................................ 42

DeleteObject(Name, Password) .................................................................. 43

Launch(Name) .............................................................................................. 43

CHostData properties .......................................................................................... 44

Connection type properties ........................................................................ 46

AssignConnection(ConnectionType) method .......................................... 48

UnassignConnection(ConnectionType) method ..................................... 48

Dialing properties ........................................................................................ 49

COM device properties ................................................................................ 50

NetBIOS device properties ......................................................................... 53

ISDN via CAPI 2.0 device properties ......................................................... 54

CHostDataEx object ............................................................................................. 55

Visual Basic sample code for host functionality ..................................... 62

Awrem32 functions ............................................................................................. 63

awConnect(FileName) ................................................................................. 63

awDisconnect() ............................................................................................. 64

FileXferFromHost(HostFile, RemoteFile) ................................................ 64

FileXferToHost(HostFile, RemoteFile) ..................................................... 65

CreateFolderOnHost(FolderName) ........................................................... 65

ExecuteHostFile(FileName) ........................................................................ 66

GetError() ...................................................................................................... 66

ConnectionStatus() ...................................................................................... 67

9Contents

Chapter 3 Visual C++ object definitions

About Visual C++ objects .................................................................................... 69

CRemoteDataManager methods ........................................................................ 71

BSTR CurrentDirectory(); ........................................................................... 71

BOOL ChangeDirectory(LPCTSTR lpszNewDirectory); ......................... 71

BOOL FindFirst(LPCTSTR lpszPattern, BSTR FAR*

pbstrFullQualName); ........................................................................... 72

BOOL FindNext(BSTR FAR* pbstrFullQualName); ................................. 72

LPDISPATCH RetrieveObject(LPCTSTR lpszFQName, short

wAccessMode, LPCTSTR lpszPassword); ......................................... 73

LPDISPATCH RetrieveObjectEx(LPCTSTR lpszFQName, short

wAccessMode, LPCTSTR lpszPassword); ......................................... 73

LPDISPATCH CreateObject(LPCTSTR lpszFQName); ............................ 74

LPDISPATCH CreateObjectEx(LPCTSTR lpszFQName); ........................75

BOOL DeleteObject(LPCTSTR lpszFQName, LPCTSTR

lpszPassword); ...................................................................................... 76

BOOL Launch(LPCTSTR lpszFQName); .................................................... 76

CRemoteData object ............................................................................................ 77

Get and Set methods ...................................................................................77

Remote object Detail methods ................................................................... 79

Remote object methods ............................................................................... 82

CRemoteDataEx object ........................................................................................ 85

Visual C++ sample code for remote functionality .................................. 85

CHostDataManager methods ............................................................................. 86

BSTR CurrentDirectory(); ........................................................................... 86

BOOL ChangeDirectory(LPCTSTR lpszNewDirectory); ......................... 86

BOOL FindFirst(LPCTSTR lpszPattern, BSTR FAR*

pbstrFullQualName); ........................................................................... 87

BOOL FindNext(BSTR FAR* pbstrFullQualName); ................................. 87

LPDISPATCH RetrieveObject(LPCTSTR lpszFQName, short

wAccessMode, LPCTSTR lpszPassword); ......................................... 88

LPDISPATCH RetrieveObjectEx(LPCTSTR lpszFQName, short

wAccessMode, LPCTSTR lpszPassword); ......................................... 89

LPDISPATCH CreateObject(LPCTSTR lpszName); ................................. 90

LPDISPATCH CreateObjectEx(LPCTSTR lpszName); ............................. 90

BOOL DeleteObject(LPCTSTR lpszFQName, LPCTSTR

lpszPassword); ...................................................................................... 91

BOOL Launch(LPCTSTR lpszFQName); .................................................... 91

CHostData object ................................................................................................. 92

Get and Set methods ...................................................................................92

Host object Detail methods ........................................................................ 93

Host object methods .................................................................................... 97

10 Contents

CHostDataEx object ...........................................................................................101

Visual C++ sample code for host functionality .....................................103

Awrem32 functions ........................................................................................... 104

boolean awConnect(BSTR FileName); ....................................................104

boolean awDisconnect(); ...........................................................................105

boolean FileXferFromHost(BSTR HostFile, BSTR RemoteFile); .........105

boolean FileXferToHost(BSTR HostFile, BSTR RemoteFile); ..............105

boolean CreateFolderOnHost(BSTR FolderName); ...............................106

boolean ExecuteHostFile(BSTR FileName); ...........................................106

BSTR GetError(); ........................................................................................107

short ConnectionStatus(); .........................................................................107

Index

This manual suits for next models

Table of contents

Other Symantec Software manuals

Symantec

Symantec ALTIRIS BARCODE SOLUTION 7.0 - V1.0 User manual

Symantec

Symantec PCANYWHERE - V 12.0 AUTOMATION GUIDE User manual

Symantec

Symantec NORTON 360 5.0 User manual

Symantec

Symantec CONFLICTMANAGER 8.0 - REFERENCE V1.0 Service manual

Symantec

Symantec 12608434 - Norton Internet Security 2008 User manual

Symantec

Symantec 10460591 - Mail Security 5.0 User manual

Symantec

Symantec ALTIRIS CLIENT MANAGEMENT SUITE 7.0 SP2 -... User manual

Symantec

Symantec WINDOWS INSTALLER EDITOR 8.0 Service manual

Symantec

Symantec ALTIRIS INVENTORY 7.0 SP2 - FOR NETWORK DEVICES... User manual

Symantec

Symantec ALTIRIS 6 INVENTORY SOLUTION User manual

Symantec

Symantec ALTIRIS CLIENT MANAGEMENT SUITE 7.0 SP2 -... User manual

Symantec

Symantec ALTIRIS INVENTORY 7.0 SP2 - FOR NETWORK DEVICES... User manual

Symantec

Symantec GHOST - V 15.0 User manual

Symantec

Symantec ALTIRIS ASSET MANAGEMENT SUITE 7.0 - V1.0 User manual

Symantec

Symantec 20006136 - Norton 360 Premier Edition 3.0... User manual

Symantec

Symantec WINDOWS INSTALLER EDITOR 7.0 SP2 - REFERENCE FOR WISE INSTALLATION STUDIO... User manual

Symantec

Symantec WISE VIRTUAL PACKAGE EDITOR 7.0 SP2 - REFERENCE FOR WISE INSTALLATION STUDIO... User manual

Symantec

Symantec 10551441 - AntiVirus Corporate Edition User manual

Symantec

Symantec 14125628 - Norton Internet Security 2009 User manual

Symantec

Symantec 10514879 - Norton Confidential User manual

Symantec

Symantec 10097944 - 10PK NORTON ANTIVIRUS 2004 User manual

Symantec

Symantec 10024200 - 50PK SYM ANTIVIRUS 8.0 User manual

Symantec

Symantec 10765539 - Mail Security For SMTP Technical manual

Symantec

Symantec WISE MOBILE DEVICE PACKAGE EDITOR 7.0 SP2 - REFERENCE FOR WISE INSTALLATION STUDIO... Service manual

Popular Software manuals by other brands

COMPRO

COMPRO COMPROFM manual

Muratec

Muratec OFFICEBRIDGE ONLINE user guide

Oracle

Oracle Contact Center Anywhere 8.1 installation guide

Adobe

Adobe 65007312 - Photoshop Lightroom Programmer's guide

Avaya

Avaya NULL One-X for RIM Blackberry user guide

HP ProLiant BL420c user guide

PS Audio

PS Audio PowerPlay Programming manual

Brady

Brady LOCKOUT PRO 3.0 Administrator's guide

Avaya

Avaya Interaction Center user guide

Texas Instruments

Texas Instruments TI-83 Plus Silver Edition Guide book

Novell

Novell GROUPWISE 8 - INTERNET AGENT manual

Oracle

Oracle Application 9i Configuration guide

Acer

Acer RDM user guide

Canon

Canon Vixia HF21 instruction manual

Canon

Canon ZR950 instruction manual

Samsung

Samsung Auto Backup user manual

Polycom

Polycom Vortex EF2201 Application note

Brocade Communications Systems

Brocade Communications Systems Brocade 8/12c user manual