Symantec pcanywhere Handleiding OLEautomatisering

Symantec pcAnywhere™ Handleiding OLEautomatisering

Symantec pcAnywhere™ Handleiding OLE-automatisering De software die in dit boek wordt beschreven, valt onder een licentieovereenkomst en mag alleen worden gebruikt in overeenstemming met de voorwaarden van deze overeenkomst. Documentatie versie 11.5

Copyrightinformatie Copyright © 2004 Symantec Corporation. Alle rechten voorbehouden. Alle technische informatie die door Symantec Corporation beschikbaar wordt gesteld, is het auteursrechtelijk beschermde werk van Symantec Corporation en eigendom van Symantec Corporation. GEEN GARANTIE. Symantec Corporation garandeert niet dat de technische documentatie zoals deze wordt geleverd, voldoet aan de door u gestelde eisen wat betreft nauwkeurigheid of gebruik. Het gebruik van de technische documentatie of de inhoud daarvan is voor risico van de gebruiker. De documentatie kan technische of andere onnauwkeurigheden of typografische fouten bevatten. Symantec behoudt zich het recht voor wijzigingen aan te brengen zonder voorafgaande kennisgeving. Niets uit deze publicatie mag worden gekopieerd zonder uitdrukkelijke schriftelijke toestemming van Symantec Corporation, 20330 Stevens Creek Blvd., Cupertino, CA 95014.

Handelsmerken Symantec, het Symantec-logo en pcAnywhere zijn in de VS gedeponeerde handelsmerken van Symantec Corporation. Microsoft, Windows, Windows NT, MS-DOS en het Windowslogo zijn gedeponeerde handelsmerken of handelsmerken van Microsoft Corporation in de Verenigde Staten en andere landen. Andere merk- en productnamen die in deze handleiding worden genoemd, kunnen handelsmerken of gedeponeerde handelsmerken zijn van de respectievelijke bedrijven. Deze handelsmerken worden hierbij erkend. Gedrukt in Ierland 10

9

8

7

6

5

4

3

2

1

Inhoudsopgave

Hoofdstuk 1

OLE-automatisering met Symantec pcAnywhere gebruiken Info over OLE-automatisering ............................................................................. 8 Info over de pcAnywhere Automation Server ................................................... 8 Wat u kunt doen met de pcAnywhere Automation Server ............................. 9 Voordat u begint .................................................................................................... 9 De externe engine automatisch registreren .............................................. 9 De externe engine handmatig registreren ............................................... 10 Toegang tot de pcAnywhere Automation Server .................................... 10 Toegang tot de pcAnywhere Automation Server via Visual Basic ..................................................................................... 10 Toegang tot de pcAnywhere Automation Server via Visual C++ ....................................................................................... 12 Host- en externe OLE-objecten starten .................................................... 14 Waar vindt u meer informatie ........................................................................... 14

Hoofdstuk 2

Definities van Visual Basic-objecten Info over Visual Basic-objecten ......................................................................... 15 CRemoteDataManager-methoden ..................................................................... 17 CurrentDirectory() ....................................................................................... 17 ChangeDirectory(NewDirectory) ............................................................... 17 FindFirst(Pattern, Name string) ................................................................ 18 FindNext(Name) ........................................................................................... 18 RetrieveObject(Name, AccessMode, Password) ...................................... 19 RetrieveObjectEx(Name, AccessMode, Password) .................................. 20 CreateObject(Name) ..................................................................................... 20 CreateObjectEx(Name) ................................................................................ 21 DeleteObject(Name, Password) .................................................................. 21 CRemoteData-eigenschappen ............................................................................ 22 Eigenschappen van het verbindingstype ................................................. 25 Kieseigenschappen ...................................................................................... 27 COM-apparaateigenschappen .................................................................... 28 Eigenschappen van NetBIOS-apparaat .................................................... 31 ISDN via CAPI 2.0-apparaateigenschappen ............................................. 31 Eigenschappen van netwerkapparaat (TCP/IP, SPX) voor gateways ....................................................................................... 32

4 Inhoudsopgave

CRemoteDataEx-object ....................................................................................... 32 Voorbeeld van Visual Basic-code voor externe functionaliteit ....................................................................................... 34 CHostDataManager-methoden .......................................................................... 36 CurrentDirectory() ....................................................................................... 36 FindFirst(Pattern, Name string) ................................................................ 36 FindNext(Name) ........................................................................................... 37 RetrieveObject(Name, AccessMode, Password) ...................................... 37 RetrieveObjectEx(Name, AccessMode, Password) .................................. 38 CreateObject(Name) ..................................................................................... 39 CreateObjectEx(Name) ................................................................................ 39 DeleteObject(Name, Password) .................................................................. 40 Launch(Name) .............................................................................................. 40 CHostData-eigenschappen ................................................................................. 41 Eigenschappen van het verbindingstype ................................................. 43 AssignConnection(ConnectionType) method .......................................... 45 UnassignConnection(ConnectionType)-methode .................................. 46 Kieseigenschappen ...................................................................................... 46 COM-apparaateigenschappen .................................................................... 47 Eigenschappen van NetBIOS-apparaat .................................................... 50 ISDN via CAPI 2.0-apparaateigenschappen ............................................ 51 Eigenschappen van netwerkapparaat (TCP/IP, SPX) voor gateways ....................................................................................... 51 CHostDataEx-object ............................................................................................ 52 Voorbeeld van Visual Basic-code voor hostfunctionaliteit ................... 60 Awrem32-functies ............................................................................................... 61 awConnect(FileName) ................................................................................. 61 awDisconnect() ............................................................................................. 62 FileXferFromHost(HostFile, RemoteFile) ................................................ 62 FileXferToHost(HostFile, RemoteFile) ..................................................... 63 CreateFolderOnHost(FolderName) ........................................................... 63 ExecuteHostFile(FileName) ........................................................................ 64 GetError() ...................................................................................................... 64 ConnectionStatus() ...................................................................................... 64

Inhoudsopgave

Hoofdstuk 3

Definities van Visual C++-objecten Info over Visual C++-objecten ........................................................................... 65 CRemoteDataManager-methoden ..................................................................... 67 BSTR CurrentDirectory(); ........................................................................... 67 BOOL ChangeDirectory(LPCTSTR lpszNewDirectory); ......................... 67 BOOL FindFirst(LPCTSTR lpszPattern, BSTR FAR* pbstrFullQualName); ...................................................... 68 BOOL FindNext(BSTR FAR* pbstrFullQualName); ................................. 68 LPDISPATCH RetrieveObject(LPCTSTR lpszFQName, short wAccessMode, LPCTSTR lpszPassword); ............................... 69 LPDISPATCH RetrieveObjectEx(LPCTSTR lpszFQName, short wAccessMode, LPCTSTR lpszPassword); ............................... 69 LPDISPATCH CreateObject(LPCTSTR lpszFQName); ............................ 70 LPDISPATCH CreateObjectEx(LPCTSTR lpszFQName); ........................ 71 BOOL DeleteObject(LPCTSTR lpszFQName, LPCTSTR lpszPassword); .................................................................... 72 BOOL Launch(LPCTSTR lpszFQName); .................................................... 72 CRemoteData-object ............................................................................................ 73 Get- en Set-methoden ................................................................................. 73 Methoden details extern object ................................................................. 75 Methoden van externe objecten ................................................................ 78 CRemoteDataEx-object ....................................................................................... 81 Voorbeeld van Visual C++-code voor externe functionaliteit ............... 82 CHostDataManager-methoden .......................................................................... 83 BSTR CurrentDirectory(); ........................................................................... 83 BOOL ChangeDirectory(LPCTSTR lpszNewDirectory); ......................... 83 BOOL FindFirst(LPCTSTR lpszPattern, BSTR FAR* pbstrFullQualName); ...................................................... 84 BOOL FindNext(BSTR FAR* pbstrFullQualName); ................................. 84 LPDISPATCH RetrieveObject(LPCTSTR lpszFQName, short wAccessMode, LPCTSTR lpszPassword); ............................... 85 LPDISPATCH RetrieveObjectEx(LPCTSTR lpszFQName, short wAccessMode, LPCTSTR lpszPassword); ............................... 86 LPDISPATCH CreateObject(LPCTSTR lpszName); ................................. 87 LPDISPATCH CreateObjectEx(LPCTSTR lpszName); ............................. 87 BOOL DeleteObject(LPCTSTR lpszFQName, LPCTSTR lpszPassword); .................................................................... 88 BOOL Launch(LPCTSTR lpszFQName); .................................................... 88

5

6 Inhoudsopgave

CHostData-object ................................................................................................. 89 Get- en Set-methoden ................................................................................. 89 Methoden details hostobject ...................................................................... 90 Hostobjectmethoden ................................................................................... 95 CHostDataEx-object .......................................................................................... 100 Voorbeeld van Visual C++-code voor hostfunctionaliteit ................... 102 Awrem32-functies ............................................................................................. 103 boolean awConnect(BSTR FileName); .................................................... 103 Boolean awDisconnect(); ........................................................................... 103 Boolean FileXferFromHost(BSTR HostFile, BSTR RemoteFile); ............................................................................. 104 Boolean FileXferToHost(BSTR HostFile, BSTR RemoteFile); ............................................................................. 104 Boolean CreateFolderOnHost(BSTR FolderName); .............................. 105 Boolean ExecuteHostFile(BSTR FileName); ........................................... 105 BSTR GetError(); ........................................................................................ 106 short ConnectionStatus(); ......................................................................... 106

Index Service en ondersteuning

Hoofdstuk

OLE-automatisering met Symantec pcAnywhere gebruiken In dit hoofdstuk worden de volgende onderwerpen besproken: ■

Info over OLE-automatisering

■

Info over de pcAnywhere Automation Server

■

Wat u kunt doen met de pcAnywhere Automation Server

■

Voordat u begint

■

Waar vindt u meer informatie

1

8 OLE-automatisering met Symantec pcAnywhere gebruiken Info over OLE-automatisering

Info over OLE-automatisering OLE-automatisering is een technologie waarmee u een externe toepassing of een ander ontwikkelprogramma (zoals een script of macro) kunt maken waarmee u een functie binnen een toepassing kunt besturen en automatiseren. OLE-automatisering bestaat uit de volgende onderdelen: ■

OLE-automatiseringsserver: een toepassing die of softwareonderdeel dat de eigen functionaliteit zo beschikbaar stelt voor andere toepassingen of ontwikkelprogramma's dat deze die functionaliteit kunnen gebruiken. De pcAnywhere Automation Server is een voorbeeld van een OLE-automatiseringsserver. Zie "Info over de pcAnywhere Automation Server" op pagina 8.

■

OLE-automatiseringscontroller: een toepassing die of ontwikkelprogramma dat de onderdelen benadert en bestuurt die door de OLE-automatiseringsserver ter beschikking zijn gesteld. U kunt elke programmeertaal gebruiken die OLE-automatisering ondersteunt. De twee meest gangbare programmeertalen zijn Microsoft Visual Basic en Microsoft Visual C++.

Een externe toepassing die een automatiseringsserver benadert, maakt eerst verbinding met de server en vraagt vervolgens om toegang tot een of meer van de gepubliceerde interfaces van de server. Een interface is een beginpunt dat u toegang geeft tot een of meer gerelateerde methoden of eigenschappen. Als een toepassing eenmaal een interface op de server krijgt, belt deze alle interfacemethoden alsof deze deel uitmaken van de externe toepassing.

Info over de pcAnywhere Automation Server Met de pcAnywhere Automation Server kunnen externe toepassingen externe, host- en bellergegevensbestanden van pcAnywhere beheren voor het automatiseren van externe beheertaken en taken voor het overbrengen van bestanden. De pcAnywhere Automation Server werkt als een programmeerbare vervanging voor de Symantec pcAnywhere-gebruikersinterface en heeft een groot gedeelte van de standaardfuncties overgenomen. Wanneer u bijvoorbeeld een hostobject in pcAnywhere maakt, wordt standaard het eerst beschikbare TAPI-modemapparaat toegewezen. Hetzelfde gebeurt wanneer u een hostobject via de pcAnywhere Automation Server maakt en de lijst met toegewezen verbindingen opsomt. In dit geval is het eerste beschikbare TAPI-modemapparaat reeds toegewezen.

OLE-automatisering met Symantec pcAnywhere gebruiken Wat u kunt doen met de pcAnywhere Automation Server

Wat u kunt doen met de pcAnywhere Automation Server Met de pcAnywhere Automation Server kunt u een groot aantal beheer- en productiviteitstaken automatiseren. U kunt bijvoorbeeld het volgende doen: ■

Automatisch distribueren en installeren van software-updates op meerdere computers in een netwerk

■

Plannen van automatische verzending van bestanden naar andere computers voor controle en archivering

■

Automatisch toevoegen van een naam aan of verwijderen van een naam uit de goedgekeurde gebruikerslijst op elke pcAnywhere-host in een netwerk

Deze handleiding bevat diverse voorbeelden die zijn geschreven in Visual Basic en C++ en illustreren op welke manier verbinding kan worden gemaakt met de pcAnywhere Automation Server en hoe deze kan worden gebruikt. Zie "Definities van Visual Basic-objecten" op pagina 15. Zie "Definities van Visual C++-objecten" op pagina 65.

Voordat u begint Bij het maken van een verbinding met de automatiseringsserver en de bijbehorende interfaces worden identificatieparameters, oftewel Globally Unique Identifiers (GUID'S), aan de API-functies van de automatiseringsbibliotheek doorgegeven. Een afzonderlijke GUID wordt toegewezen aan de pcAnywhere Automation Server en aan elke weergegeven interface. Deze GUID's moeten in het systeemregister staan om een externe toepassing aan de pcAnywhere Automation Server en de interfaces te kunnen koppelen. U kunt de GUID-vermeldingen automatisch registreren als u de externe toepassing uitvoert op een computer waarop Symantec pcAnywhere is geïnstalleerd. Als dit niet het geval is, moet u de GUID-vermeldingen handmatig registreren. Zie "De externe engine automatisch registreren" op pagina 9. Zie "De externe engine handmatig registreren" op pagina 10.

De externe engine automatisch registreren Voordat u verbinding met een andere computer maakt om de OLE-client voor de eerste keer te gebruiken, moet u de externe engine zelf registreren. U kunt dit automatisch doen wanneer u een extern object in Symantec pcAnywhere start.

9

10 OLE-automatisering met Symantec pcAnywhere gebruiken Voordat u begint

De externe engine automatisch registreren 1

U opent Symantec pcAnywhere als volgt: ■

Dubbelklik op het bureaublad op het programmapictogram van Symantec pcAnywhere.

■

Klik op de taakbalk van Windows op Start > Programma's > Symantec pcAnywhere.

2

Klik in het venster pcAnywhere-beheer op Externe computers.

3

Dubbelklik op een externe-verbindingsitem. De externe engine wordt nu geregistreerd. U hoeft de verbinding niet helemaal tot stand te brengen.

De externe engine handmatig registreren Als pcAnywhere niet is geïnstalleerd op de computer waarop u de externe toepassing gaat uitvoeren, moet u de GUID's handmatig registreren door het programmabestand van pcAnywhere Automation Server (Winawsvr.exe) uit te voeren. U hoeft dit programmabestand maar één keer uit te voeren om de GUID's in het register te installeren. Het bestand Winawsvr.exe staat in de standaardgegevensmap van Symantec pcAnywhere.

Toegang tot de pcAnywhere Automation Server pcAnywhere Automation Server is toegankelijk via elk taalplatform dat OLE-automatisering ondersteunt. De twee populairste taalplatforms die OLE-automatisering ondersteunen, zijn Microsoft Visual C++ en Microsoft Visual Basic. De coderingsprincipes van deze twee platforms zijn dezelfde, hoewel in de Visual Basic-omgeving veel van de lagere werkzaamheden door het run-time systeem op de achtergrond worden uitgevoerd.

Toegang tot de pcAnywhere Automation Server via Visual Basic De programmeertaal Visual Basic heeft ingebouwde ondersteuning voor interactie met OLE-automatiseringsservers, zoals de pcAnywhere Automation Server. U kunt een standaard exe-project maken en vervolgens de code in elke methode voor toegang tot de pcAnywhere Automation Server invoeren. Visual Basic haalt de geavanceerde methodeaanroepen uit de bronbestanden op en breidt deze aanroepen intern uit in de overeenkomende, eenvoudigere methodeaanroepen voor OLE-automatisering. Zie "Definities van Visual Basic-objecten" op pagina 15.

OLE-automatisering met Symantec pcAnywhere gebruiken Voordat u begint

U benadert als volgt de pcAnywhere Automation Server via Visual Basic: 1

Voeg een objectvariabelen-paar toe aan elk van de pcAnywhere-objecten die u wilt benaderen. Wanneer u bijvoorbeeld met externe objecten werkt, voegt u een RemoteDataManager en een RemoteDataObject als object toe.

2

Gebruik de RemoteDataManager om aan de gegevensbeheerder van het externe object te koppelen. Roep bijvoorbeeld de methode CreateObject aan met WINAWSVR.REMOTEDATAMANAGER als parameter. Visual Basic gebruikt de tekstuele parameter om de identificatie van de beheerder in het register op te zoeken en geeft de interface aan die beheerder terug.

3

Als er eenmaal een geldig gegevensbeheerobject is, gebruikt u dit object om een van de volgende acties uit te voeren:

4

■

De huidige map bepalen

■

Naar een andere map gaan

■

De gekoppelde gegevensobjectbestanden in de huidige map opsommen

■

Een gegevensobjectbestand maken, ophalen of verwijderen

Nadat een gegevensobject is gemaakt of opgehaald, kunt u de eigenschappen van dit object ophalen of instellen. Bij de syntaxis van Visual Basic wordt geen eigenschappennaam gebruikt om onderscheid te maken tussen het ophalen of instellen van de waarde ervan. In plaats daarvan bepaalt de positie van de eigenschap in relatie tot de toekenningsoperator of de onderliggende methodeaanroep een Get of een Set is. De volgende voorbeelden geven het verschil aan tussen een Get en een Set: ■

U haalt de telefoonnummerwaarde van een object op door de eigenschappennaam rechts van de toekenningsoperator te plaatsen, bijvoorbeeld s = RemoteData.PhoneNumber (), waarbij s een stringvariabele is.

■

Wanneer u het telefoonnummer wilt instellen, plaatst u de eigenschappennaam links van de toekenningsoperator, bijvoorbeeld RemoteData.PhoneNumber = "555-1212".

11

12 OLE-automatisering met Symantec pcAnywhere gebruiken Voordat u begint

Toegang tot de pcAnywhere Automation Server via Visual C++ De pcAnywhere Automation Server gebruikt typebibliotheken voor het weergeven van informatie over de eigen interfaces en de methoden voor het automatiseren van clients die zijn geschreven in Visual C++. Deze typebibliotheken gebruiken Microsoft Foundation Classes (MFC), die met behulp van de Visual C++ ClassWizard in de toepassing kunnen worden geïmporteerd. De gegevensbeheerklassen in de typebibliotheken bieden de functionaliteit die nodig is om een interface op te halen voor de pcAnywhere Automation Server en om bewerkingen uit te voeren op het gekoppelde objecttype van de interface. Gebruik het gegevensbeheerobject om de volgende acties uit te voeren: ■

De huidige map bepalen of naar een andere map gaan

■

De lijst met gegevensobjectbestanden in de huidige map opsommen

■

Een benoemd object maken, ophalen of verwijderen

Een gemaakt of opgehaald object gebruikt de gekoppelde gegevensobjectklasse om een of meer weergegeven eigenschappen te onderzoeken of aan te passen. De meeste van deze eigenschappen worden weergegeven via een methodenpaar dat begint met het woord Get of Set. U kunt bijvoorbeeld de methode GetPhoneNumber aanroepen om de huidige telefoonnummereigenschap van het object te bekijken en daarna het SetPhoneNumber om deze in te stellen. Zie "Definities van Visual C++-objecten" op pagina 65.

Klassen importeren en bekijken De pcAnywhere Automation Server gebruikt de volgende typebibliotheken: ■

Winawsvr.tlb: levert de gegevens die nodig zijn om verbinding te maken met pcAnywhere Automation Server en om de interfaces van deze server te benaderen.

■

Awrem32.tlb: levert de gegevens voor het besturen van de pcAnywhereverbindingen.

OLE-automatisering met Symantec pcAnywhere gebruiken Voordat u begint

Klassen importeren en bekijken In de volgende procedures wordt uitgelegd hoe u de klassendefinities vanuit de typebibliotheken van pcAnywhere Automation Server naar de MFC-toepassing importeert en vervolgens de klassen bekijkt die aan de toepassing zijn toegevoegd. U importeert klassen als volgt: 1

Maak een MFC-toepassing in Visual C++.

2

Klik op Class Wizard in het menu View.

3

Klik in het dialoogvenster Class Wizard op Add Class en vervolgens op From a type library.

4

Dubbelklik op winawsvr.tlb.

5

Klik op OK in het dialoogvenster Confirm Classes om alle klassendefinities te importeren.

6

Klik in het dialoogvenster Class Wizard op Add Class en vervolgens op From a type library.

7

Dubbelklik op awrem32.tlb.

8

Klik op OK in het dialoogvenster Confirm Classes om alle klassendefinities te importeren.

9

Klik op OK in het dialoogvenster Class Wizard om het importeren te voltooien. De klassen worden aan de toepassing toegevoegd. Met deze klassen kunt u objecten aanpassen en verbindingen beheren. Bij het importeren van klassendefinities vanuit typebibliotheken worden de ondersteuningsbestanden ook aan de toepassing toegevoegd. In deze bestanden staan de klassendefinities en de implementatiebroncode voor de pcAnywhere Automation Server. Zie "De klassendefinities en implementatiebestanden weergeven" op pagina 14.

U geeft als volgt toegevoegde klassen weer: 1

Open de MFC-toepassing in Visual C++.

2

Klik in het venster Workspace op het tabblad ClassView.

13

14 OLE-automatisering met Symantec pcAnywhere gebruiken Waar vindt u meer informatie

De klassendefinities en implementatiebestanden weergeven Wanneer u de typebibliotheken van pcAnywhere Automation Server in de toepassing importeert, worden de volgende bestanden toegevoegd: ■

Winawsvr.h

■

Winawsvr.cpp

■

Awrem32.h

■

Awrem32.cpp

In deze bestanden staan de klassendefinities en de implementatiebroncode voor de pcAnywhere Automation Server. U hoeft deze bestanden niet te bewerken, maar in elk toepassingsbronbestand waarin aanroepen naar methoden van pcAnywhere Automation Server staan, moet het bestand Winawsvr.h staan. U geeft als volgt de klassendefinities en implementatiebestanden weer: 1

Open de MFC-toepassing in Visual C++.

2

Klik in het venster Workspace op het tabblad FileView.

Host- en externe OLE-objecten starten Voor Symantec pcAnywhere moeten alle hostobjecten en externe objecten zijn opgeslagen in de standaardgegevensmap. Voordat u een hostobject of extern object start dat u met OLE hebt gemaakt, moet u eerst controleren of dat object in de standaardgegevensmap van pcAnywhere staat.

Waar vindt u meer informatie Zie voor meer informatie over OLE-automatisering de volgende publicaties: ■

Blaszczak, Mike. 1997. Professional MFC Visual C++ 5. Birmingham, VK: Wrox Press.

■

Box, Don. 1998. Essential COM. Reading, Mass.: Addison-Wesley.

■

Brockschmidt, Kraig. 1995. Inside OLE, Second Edition. Redmond, Wash.: Microsoft Press.

■

Horton, Ivor. 1997. Beginning MFC Programming. Birmingham, VK.: Wrox Press.

■

Rogerson, Dale. 1997. Inside COM. Redmond, Wash.: Microsoft Press.

■

Templeman, Julian. 1997. Beginning MFC COM Programming. Birmingham, VK: Wrox Press.

Hoofdstuk

2

Definities van Visual Basic-objecten In dit hoofdstuk worden de volgende onderwerpen besproken: ■

Info over Visual Basic-objecten

■

CRemoteDataManager-methoden

■

CRemoteData-eigenschappen

■

CRemoteDataEx-object

■

CHostDataManager-methoden

■

CHostData-eigenschappen

■

CHostDataEx-object

■

Awrem32-functies

Info over Visual Basic-objecten De pcAnywhere Automation Server beschikt over de volgende onderdelen voor ondersteuning van OLE-automatisering: ■

Winawsvr: levert de gegevens die nodig zijn om verbinding te maken met pcAnywhere Automation Server en om de interfaces van deze server te benaderen.

■

Awrem32: levert de gegevens voor het besturen van de pcAnywhereverbindingen.

16 Definities van Visual Basic-objecten Info over Visual Basic-objecten

Tabel 2-1 beschrijft de objecten waaruit Winawsvr bestaat. Tabel 2-1

Winawsvr-objecten

Object

Beschrijving

Verwijzing

CRemoteDataManager

Levert de methoden voor het maken, openen, wijzigen, opslaan en verwijderen van CRemoteData-objecten.

Zie "CRemoteDataManagermethoden" op pagina 17.

CRemoteData

Definieert de parameters voor het benaderen en besturen van de externe functionaliteit van pcAnywhere.

Zie "CRemoteDataeigenschappen" op pagina 22.

CHostDataManager

Levert de methoden voor het maken, openen, wijzigen, opslaan en verwijderen van CHostData-objecten.

Zie "CHostDataManagermethoden" op pagina 36.

CHostData

Definieert de parameters voor het benaderen en besturen van de hostfunctionaliteit van pcAnywhere.

Zie "CHostDataeigenschappen" op pagina 41.

Zie "CRemoteDataEx-object" op pagina 32.

Zie "CHostDataEx-object" op pagina 52.

Awrem32 heeft één object dat bestaat uit acht interfaces voor ondersteuning van externe besturings- en bestandsverzendingssessies. Zie "Awrem32-functies" op pagina 61. Sommige functies, zoals de gateway-functionaliteit, worden niet langer ondersteund. Voor gebruik met oudere versies van pcAnywhere worden echter objectdefinities geleverd. Voor functies waarbij wachtwoorden zijn vereist, kunt u wachtwoorden instellen, maar niet ophalen. Dit is vanuit het oogpunt van de veiligheid gedaan.

Definities van Visual Basic-objecten CRemoteDataManager-methoden

CRemoteDataManager-methoden De CRemoteDataManager-methoden leveren de parameters en retourwaarden voor het benaderen en besturen van CRemoteData-objecten.

CurrentDirectory() Retourneert de volledige padnaam van de huidige map waarin externe objecten van pcAnywhere zijn opgeslagen. Zie Tabel 2-2 voor de definitie van de retourwaarde CurrentDirectory(). Tabel 2-2

CurrentDirectory()-retourwaarde

Retourwaarde

Beschrijving

String

De volledige padnaam van de huidige pcAnywheregegevensmap.

ChangeDirectory(NewDirectory) Wijzigt de huidige map waarin externe objecten van pcAnywhere zijn opgeslagen. Zie Tabel 2-3 voor een definitie van de parameter ChangeDirectory. Tabel 2-3

ChangeDirectory-parameter

Parameter

Beschrijving

NewDirectory

Naam van een bestaande map.

Zie Tabel 2-4 voor de definitie van de retourwaarde van ChangeDirectory. Tabel 2-4

ChangeDirectory-retourwaarde

Retourwaarde

Beschrijving

Boolean

TRUE indien gelukt.

17

18 Definities van Visual Basic-objecten CRemoteDataManager-methoden

FindFirst(Pattern, Name string) Vindt op basis van het opgegeven bestandsnaampatroon het eerste externe objectbestand (*.chf) van pcAnywhere in de huidige map. Zie Tabel 2-5 voor een definitie van de FindFirst-parameters. Tabel 2-5

FindFirst-parameters

Parameter

Beschrijving

Pattern as string

Bestandsnaampatroon voor het filteren van objectbestanden (een asterisk [*] vindt alle hostobjectbestanden in de huidige map).

Name as string

Retourbuffer voor de volledige padnaam van het externobjectbestand dat overeenkomt met het opgegeven patroon.

Zie Tabel 2-6 voor de definitie van de retourwaarde van FindFirst. Tabel 2-6

FindFirst-retourwaarde

Retourwaarde

Beschrijving

Boolean

TRUE als een extern-objectbestand wordt gevonden dat overeenkomt met het opgegeven patroon. De volledige padnaam van het overeenkomende bestand wordt in Name opgeslagen.

FindNext(Name) Nadat FindFirst() is aangeroepen om de naam van een extern-objectbestand in de huidige map te plaatsen, kan FindNext() worden aangeroepen om het eventuele volgende bestand met een overeenkomend patroon te vinden. Zie Tabel 2-7 voor een definitie van de parameter FindNext. Tabel 2-7

FindNext-parameter

Parameter

Beschrijving

Name as string

Retourbuffer voor de volledige padnaam van het externobjectbestand dat overeenkomt met het patroon dat in de eerste oproep voor FindFirst() is opgegeven.


Zie Tabel 2-8 voor de definitie van de retourwaarde van FindNext. Tabel 2-8

FindNext-retourwaarde

Retourwaarde

Beschrijving

Boolean

TRUE als een ander extern-objectbestand is gevonden dat overeenkomt met het patroon dat in de oproep voor FindFirst() is opgegeven. De volledige padnaam van het overeenkomende bestand wordt in Name opgeslagen.

RetrieveObject(Name, AccessMode, Password) Haalt een CRemoteData-object op bestandsnaam op. Zie Tabel 2-9 voor een definitie van de RetrieveObject-parameters. Tabel 2-9

RetrieveObject-parameters

Parameter

Beschrijving

Name as string

De naam van het te laden, volledig gekwalificeerde extern-objectbestand.

AccessMode as integer

Geeft op hoe dit object moet worden gebruikt. Dit is gekoppeld aan de wachtwoordbeveiliging. De volgende opties zijn beschikbaar:

Password as string

■

0 = Niet opgegeven

■

1 = Alleen weergeven

■

2 = Weergeven en aanpassen

■

3 = Uitvoeren

Objectwachtwoord. Kan NULL zijn.

Zie Tabel 2-10 voor de definitie van de retourwaarde van RetrieveObject. Tabel 2-10

RetrieveObject-retourwaarde

Retourwaarde

Beschrijving

Object

CRemoteData-object uit het opgegeven bestand.

19

20 Definities van Visual Basic-objecten CRemoteDataManager-methoden

RetrieveObjectEx(Name, AccessMode, Password) Haalt een CRemoteDataEx-object op bestandsnaam op. Zie Tabel 2-11 voor een definitie van de RetrieveObjectEx-parameters. Tabel 2-11

RetrieveObjectEx-parameters

Parameter

Beschrijving

Name as string




Password as string

■

0 = Niet opgegeven

■


■


■

3 = Uitvoeren


Zie Tabel 2-12 voor de definitie van de retourwaarde van RetrieveObjectEx. Tabel 2-12

RetrieveObjectEx-retourwaarde

Retourwaarde

Beschrijving

Object

CRemoteDataEx-object uit het opgegeven bestand.

CreateObject(Name) Maakt een CRemoteData-object en retourneert een LPDISPATCH-pointer naar dit object. Zie Tabel 2-13 voor de definitie van de parameter CreateObject. Tabel 2-13

CreateObject-parameter

Parameter

Beschrijving

Name as string

De naam van het volledig gekwalificeerde extern-objectbestand voor het nieuwe object


Zie Tabel 2-14 voor de definitie van de retourwaarde van CreateObject. Tabel 2-14

CreateObject-retourwaarde

Retourwaarde

Beschrijving

Object

CRemoteData

CreateObjectEx(Name) Maakt een CRemoteDataEx-object en retourneert een LPDISPATCH-pointer naar dit object. Zie Tabel 2-15 voor de definitie van de parameter CreateObjectEx. Tabel 2-15

CreateObjectEx-parameter

Parameter

Beschrijving

Name as string


Zie Tabel 2-16 voor de definitie van de retourwaarde van CreateObjectEx. Tabel 2-16

CreateObjectEx-retourwaarde

Retourwaarde

Beschrijving

Object

CRemoteDataEx

DeleteObject(Name, Password) Verwijdert een extern-objectbestand. Zie Tabel 2-17 voor een definitie van de DeleteObject-parameters. Tabel 2-17

DeleteObject-parameters

Parameter

Beschrijving

Name as string

De naam van het te verwijderen volledig gekwalificeerde extern-objectbestand.

Password as string

Objectwachtwoord.

21

22 Definities van Visual Basic-objecten CRemoteData-eigenschappen

Zie Tabel 2-18 voor de definitie van de retourwaarde van DeleteObject. Tabel 2-18

DeleteObject-retourwaarde

Retourwaarde

Beschrijving

Boolean

TRUE als het object is verwijderd.

CRemoteData-eigenschappen In Tabel 2-19 vindt u de eigenschappen en parameters die beschikbaar zijn voor het CRemoteData-object. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-19

Eigenschappen en parameters voor CRemoteData

Eigenschap

Parameter Beschrijving

.ComputerName(String)

String

Stelt de computernaam of het IP-adres van de hostcomputer in.

.PhoneNumber(String)

String

Stelt het telefoonnummer van de hostcomputer in.

.UseDialingProperties(Bool)

Bool

Stelt de kieseigenschappen van het systeem in.

.RedialCount(Integer)

Integer

Stelt in hoeveel keer wordt geprobeerd te bellen voordat de oproep wordt geannuleerd.

.RedialDelay(Integer)

Integer

Geeft op hoeveel seconden moet worden gewacht tussen de pogingen.

.AutoLoginName(String)

String

Geeft de naam van de gebruiker op voor het automatisch aanmelden. Zie "CRemoteDataEx-object" op pagina 32 voor meer informatie over het gebruik van domeinaanmeldingen.

.AutoLoginPassword(String)

String

Stelt het wachtwoord in voor automatische aanmeldingen bij het externe object. Uit het oogpunt van veiligheid wordt door de pcAnywhere Automation Server het wachtwoord niet als normale tekst weergegeven. De waarde van het wachtwoord wordt niet geretourneerd.

Definities van Visual Basic-objecten CRemoteData-eigenschappen

Tabel 2-19

Eigenschappen en parameters voor CRemoteData

Eigenschap


.Password(String)

String

Stelt het wachtwoord op het externe object in voor gebruik bij de ExecuteProtection-, ReadProtectionen WriteProtection-instellingen. Uit het oogpunt van veiligheid wordt door de pcAnywhere Automation Server het wachtwoord niet als normale tekst weergegeven. De waarde van het wachtwoord wordt niet geretourneerd.

.ExecuteProtection(Bool)

Bool

Stelt in dat een wachtwoord nodig is om het object te kunnen uitvoeren. Geef een wachtwoord op.

.ReadProtection(Bool)

Bool

Stelt in dat een wachtwoord nodig is om de eigenschappen van het externe object te kunnen bekijken. Geef een wachtwoord op.

.WriteProtection(Bool)

Bool

Stelt in dat een wachtwoord nodig is om de wijzigingen aan het externe object te kunnen opslaan. Geef een wachtwoord op.

.LogSession(Bool)

Bool

Activeert en deactiveert sessie-aanmeldingen.

.RecordFile(String)

String

Stelt het volledig gekwalificeerde pad naar en de naam van de locatie van het bestand in waarin de actieve sessie wordt opgeslagen.

.RecordSession(Bool)

Bool

Activeert en deactiveert het automatisch opnemen van sessies.

.ReadObject(String)

String

Stelt het wachtwoord van het object in. Gebruik deze eigenschap voor het vernieuwen van de lokale gegevenskopie van het externe object.

.WriteObject(String)

String

Stelt het wachtwoord van het object in. Gebruik deze eigenschap voor het maken van het externe object of het opslaan van het externe object dat u hebt gewijzigd.

23


Zie Tabel 2-20 voor de definities van de eigenschappen en retourwaarden voor CRemoteData. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen.. Tabel 2-20

Eigenschappen en retourwaarden voor RemoteData

Eigenschap

Retourwaarde

Beschrijving

String = .ComputerName

String

Retourneert de computernaam of het IP-adres van de hostcomputer.

String = .PhoneNumber

String

Retourneert het telefoonnummer van de hostcomputer.

Bool = .UseDialingProperties

Bool

Retourneert de beleigenschappen van het systeem die in het externe object zijn ingesteld.

Integer = .RedialCount

Integer

Retourneert het aantal pogingen om opnieuw te bellen dat is ingesteld in het externe object.

Integer = .RedialDelay

Integer

Retourneert het aantal seconden tussen de pogingen om opnieuw te bellen.

String = .AutoLoginName

String

Retourneert de aanmeldnaam die wordt gebruikt voor het automatisch aanmelden.

Bool = .ExecuteProtection

Bool

Retourneert de waarde van de ExecuteProtectioninstelling

Bool = .ReadProtection

Bool

Retourneert de waarde van de ReadProtectioninstelling.

Bool = .WriteProtection

Bool

Retourneert de waarde van de WriteProtectioninstelling

Bool = .LogSession

Bool

Retourneert TRUE als sessie-aanmelding is ingeschakeld.

String = .RecordFile

String

Retourneert het volledige gekwalificeerde pad naar en de naam van het sessieopnamebestand.

Bool = .RecordSession

Bool

Retourneert de waarde van de opname-instelling voor de sessie.


Eigenschappen van het verbindingstype Zie Tabel 2-21 voor de definities van de eigenschappen en parameters van het verbindingstype. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-21

Eigenschappen en parameters van het verbindingstype

Eigenschap


.ConnectionType(String)

String

Stelt het verbindingstype van het externe object in. De opgegeven waarde moet een geldig verbindingstype zijn zoals wordt gedefinieerd door de functies FirstConnectionType() en NextConnectionType(). Hieronder staan enkele voorbeelden van geldige verbindingstypen: ■

COM1

■

COM2

■

COM3

■

COM4

■

LPT1

■

LPT2

■

LPT3

■

LPT4

■

TCP/IP

■

SPX

■

NetBIOS

■

Infrarood

■

ISDN via CAPI 2.0

■

Modemnaam (zoals deze op de computer wordt vermeld)

25


Zie Tabel 2-22 voor de definities van de eigenschappen en retourwaarden van het verbindingstype. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-22

Eigenschappen en retourwaarden van het verbindingstype

Eigenschap

Retourwaarde

Beschrijving

String = .ConnectionTypes

String

Retourneert het verbindingstype van het externe object.

Integer = .ConnectionType

Integer

Retourneert het aantal beschikbare verbindingstypen. Hieronder staan enkele voorbeelden van geldige verbindingstypen: ■

COM1

■

COM2

■

COM3

■

COM4

■

LPT1

■

LPT2

■

LPT3

■

LPT4

■

TCP/IP

■

SPX

■

NetBIOS

■

Infrarood

■

ISDN via CAPI 2.0

■


String = .FirstConnectionType

String

Retourneert het eerste beschikbare verbindingstype.

String = .NextConnectionType

String

Retourneert het volgende beschikbare verbindingstype. De verbindingstypen worden opeenvolgend op nummers opgehaald die in .ConnectionType zijn ingesteld voor het opeenvolgend nummeren van alle verbindingstypen.

Bool = .FindConnectionType(ConnectionType)

Bool

Retourneert TRUE als het betreffende verbindingstype in de lijst met beschikbare verbindingstypen staat.


Kieseigenschappen Zie Tabel 2-23 voor de definities en parameters voor het instellen van de kieseigenschappen voor modemverbindingen. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-23

Eigenschappen en parameters voor kieseigenschappen

Eigenschap


.AreaCode(String)

String

Stelt het netnummer in de kieseigenschappen voor de modem in.

.CountryCode(String)

String

Stelt het landnummer in de kieseigenschappen voor de modem in.

Zie Tabel 2-24 voor de definities van de eigenschappen en retourwaarden voor de kieseigenschappen van modems. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-24

Eigenschappen en retourwaarden voor kieseigenschappen

Eigenschap

Retourwaarde

Beschrijving

String = .AreaCode

String

Retourneert het netnummer uit de kieseigenschappen.

String = .CountryCode

String

Retourneert het landnummer uit de kieseigenschappen.

Integer = .CountryCodes

Integer

Retourneert het aantal beschikbare landnummers.

String = .FirstCountryCode

String

Retourneert het eerste beschikbare landnummer uit het besturingssysteem.

String = .NextCountryCode

String

Retourneert het volgende beschikbare landnummer. De landnummers worden opeenvolgend opgehaald zoals is ingesteld in voor het opeenvolgend nummeren van alle landnummers.

27


COM-apparaateigenschappen Zie Tabel 2-25 voor een beschrijving van de eigenschappen en parameters waarmee u de poortinstellingen voor modemverbindingen en andere COMverbindingen kunt aanpassen. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-25

Eigenschappen en parameters voor COM-apparaat

Eigenschap


.ComParity(String)

String

Stelt de communicatiepariteit in. De volgende waarden zijn geldige waarden:

.ComFlowControl(String)

String

■

■

Oneven

■

Even

■

Markeer

■

Spatie

Stelt het gegevenstransport via COMverbindingen in. De volgende waarden zijn geldige waarden:

.ComStartedBy(String)

String

■

■

XONXOFF

■

RTS/CTS

■

Beide

Stelt de begininstelling van COM-verbindingen in. De volgende waarden zijn geldige waarden:

.ComEndedBy(String)

String

■

Altijd verbinding

■

Carrier detect (DCD)

■

Clear to send (CTS)

■

Data set ready (DSR)

■

Ring indicator (RI)

■

2 's ontvangen

■

Modemrespons

Stelt de eindinstelling van COM-verbindingen in. De volgende waarden zijn geldige waarden: ■

Altijd verbinding

■


■

Clear to send (CTS)

■


■

Ring indicator (RI)


Tabel 2-25


Eigenschap


.ComSpeed(Long)

Lang

Bevat de maximumsnelheid van de COMverbinding. De volgende waarden zijn geldige waarden: ■

110

■

300

■

600

■

1200

■

2400

■

4800

■

9600

■

38400

■

57600

■

115200

Zie Tabel 2-26 voor een beschrijving van de eigenschappen en retourwaarden van COM-apparaten. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-26

Eigenschappen en retourwaarden van COM-apparaat

Eigenschap

Retourwaarde

Beschrijving

String = .ComParity

String

Retourneert een van de volgende waarden voor de communicatiepariteit:

String = .ComFlowControl

String

■

■

Oneven

■

Even

■

Markeer

■

Spatie

Retourneert de instellingen van het communicatietransport van het externe object. De volgende waarden zijn geldige waarden: ■

■

XONXOFF

■

RTS/CTS

■

Beide

29


Tabel 2-26


Eigenschap

Retourwaarde

Beschrijving

String = .ComStartedBy

String

Retourneert de beginbesturing van de communicatie van COM-verbindingen. De volgende waarden zijn geldige waarden:

String = .ComEndedBy

String

■

Altijd verbinding

■


■

Clear to send (CTS)

■


■

Ring indicator (RI)

■

2 's ontvangen

■

Modemrespons

Retourneert de eindbesturing van de communicatie van COM-verbindingen. De volgende waarden zijn geldige waarden:

Long = .ComSpeed

Lang

■

Altijd verbinding

■


■

Clear to send (CTS)

■


■

Ring indicator (RI)

Retourneert de huidige instelling van de communicatiesnelheid van het externe object. De volgende waarden zijn geldige waarden: ■

110

■

300

■

600

■

1200

■

2400

■

4800

■

9600

■

38400

■

57600

■

115200


Eigenschappen van NetBIOS-apparaat Zie Tabel 2-27 voor de definitie van de eigenschap en parameter voor een NetBIOS-netwerkapparaat. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-27

NetBIOS-eigenschap en parameter

Eigenschap


.LanaNumber(Integer)

Integer

Stelt het nummer van de LAN-adapter (LANA) voor NetBIOS-verbindingen in.

Zie Tabel 2-28 voor de definitie van de eigenschap en de retourwaarde van NetBIOS. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-28

NetBIOS-eigenschap en retourwaarde

Eigenschap

Retourwaarde

Beschrijving

Integer = .LanaNumber

Integer

Retourneert de huidige instelling van het nummer van de LAN-adapter (LANA) voor NetBIOSverbindingen.

ISDN via CAPI 2.0-apparaateigenschappen Zie Tabel 2-29 voor de definitie van de eigenschappen en parameters voor Europese ISDN-verbindingen. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-29

Eigenschappen en parameters van ISDN via CAPI 2.0

Eigenschap


.CapiChannelBonding(Bool)

Bool

Activeert en deactiveert de kanaalverbinding voor ISDN CAPI-apparaten.

.CapiExtensions(String)

String

Stelt alle extra CAPI-extensies in die nodig zijn voor de communicatie.

31

32 Definities van Visual Basic-objecten CRemoteDataEx-object

Zie Tabel 2-30 voor de definitie van de eigenschappen en retourwaarden voor Europese ISDN-verbindingen. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-30

Eigenschappen en retourwaarden van ISDN via CAPI 2.0

Eigenschap

Retourwaarde

Beschrijving

Bool= .CapiChannelBonding

Bool

Retourneert de instelling van de huidige ISDN CAPI-kanaalverbinding in het externe object.

String = .CapiExtensions

String

Retourneert de huidige lijst met CAPI-extensies van het externe object.

Eigenschappen van netwerkapparaat (TCP/IP, SPX) voor gateways U kunt de volgende eigenschappen alleen met pcAnywhere 9.2x gebruiken: ■

GatewayUse as boolean

■

GatewayName as string

■

GatewayClass as string

■

GatewayParity as string

Opmerking: nieuwere versies van pcAnywhere ondersteunen de gatewayfunctionaliteit niet meer.

CRemoteDataEx-object Het CRemoteDataEx-object heeft dezelfde functies als het CRemoteData-object plus een aantal andere functies. Zie Tabel 2-31 voor een beschrijving van de eigenschappen en parameters. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-31

CRemoteDataEx-parameters

Eigenschap


.PrivateKey(String)

String

Stelt de naam van de te gebruiken container eigen sleutel in.

.CertificateName(String)

String

Stelt de algemene naam van de te gebruiken eigen sleutel in.

Definities van Visual Basic-objecten CRemoteDataEx-object

Tabel 2-31

CRemoteDataEx-parameters

Eigenschap


.EncryptionLevel(Byte)

Byte

Stelt het coderingsniveau in. De volgende waarden zijn geldige waarden: ■

-1: Geen

■

0: pcAnywhere

■

1: Symmetrisch

■

2: Openbare sleutel

.DenyLowerEncrypt(Bool)

Bool

Definieert of vanaf de externe computer een verbinding mogelijk is met een hostcomputer waarop een lager coderingsniveau wordt gebruikt.

.AutoDomain(String)

String

Stelt de domeinnaam in voor automatische aanmeldingen. Deze optie wordt gebruikt bij verificatie in NT en Windows.

Zie Tabel 2-32 voor een beschrijving van de eigenschappen en retourwaarden voor het CRemoteDataEx-object. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-32

Eigenschappen en retourwaarden van RemoteDataEx

Eigenschap

Retourwaarde

Beschrijving

String = .PrivateKey

String

Retourneert de waarde van de huidige, actieve container eigen sleutel.

String = .CertificateName

String

Retourneert de algemene naam van de actieve container eigen sleutel.

Byte = .EncryptionLevel

Byte

Retourneert een van de volgende coderingsniveaus: ■

-1: Geen

■

0: pcAnywhere

■

1: Symmetrisch

■

2: Openbare sleutel

Bool = .DenyLowerEncrypt

Bool

Retourneert de waarde van de instelling voor het weigeren van de lagere coderingsinstelling.

String = .AutoDomain

String

Retourneert de instelling van de domeinnaam voor automatische aanmeldingen. Deze optie wordt gebruikt bij verificatie in NT en Windows.

33

34 Definities van Visual Basic-objecten CRemoteDataEx-object

Voorbeeld van Visual Basic-code voor externe functionaliteit In de volgende voorbeelden met Visual Basic-codes wordt een extern gegevensobject opgehaald en worden de eigenschappen van dat object gewijzigd: Private Sub Command1_Click() Dim RemoteDataManager as Object Dim RemoteData as Object Dim s as string 'CRemoteDataManager-object maken Set RemoteDataManager = CreateObject(WINAWSVR.REMOTEDATAMANAGER) 'huidige map weergeven en wijzigen s = RemoteDataManager.CurrentDirectory() MsgBox (s) RemoteDataManager.ChangeDirectory ("C:\dev\bin.w32\data") s = RemoteDataManager.CurrentDirectory() MsgBox (s) 'externe-gegevensobject ophalen Set RemoteData = RemoteDataManager.RetrieveObjectEx("pod.CHF", 2, 0) 'enkele eigenschappen weergeven s = RemoteData.AreaCode() MsgBox (s) s = RemoteData.PhoneNumber() MsgBox (s) 'enkele eigenschappen instellen RemoteData.AreaCode = "212" RemoteData.PhoneNumber = "555-5555" 'object naar schijf schrijven RemoteData.WriteObject (0) End Sub

Gebruik de methoden FindFirst en FindNext om het externe bestand als volgt in een map weer te geven. Private Sub Command5_Click()

Definities van Visual Basic-objecten CRemoteDataEx-object

Dim RemoteDataManager as Object Dim RemoteData as Object Dim s as string Set RemoteDataManager = CreateObject("WINAWSVR.REMOTEDATAMANAGER") RemoteDataManager.ChangeDirectory ("C:\dev\bin.w32\data") RemoteDataManager.FindFirst "*", s MsgBox (s) RemoteDataManager.FindNext s MsgBox (s) End Sub

Maak een extern object. Stel het verbindingstype in op TCP/IP en de computernaam op "Host1" en start het object als volgt: Private Sub Command6_Click() Dim RemoteDataManager as Object Dim RemoteData as Object Dim s as string

Set RemoteDataManager = CreateObject("WINAWSVR.REMOTEDATAMANAGER") MsgBox (RemoteDataManager.CurrentDirectory()) RemoteDataManager.ChangeDirectory ("C:\dev\bin.w32\data") MsgBox (RemoteDataManager.CurrentDirectory()) Set RemoteData = RemoteDataManager.CreateObject("test") RemoteData.ConnectionType = "TCP/IP" RemoteData.ComputerName = "Host1" s = RemoteData.ConnectionType MsgBox (s) s = RemoteData.ComputerName MsgBox (s) RemoteData.WriteObject (0) End Sub

35

36 Definities van Visual Basic-objecten CHostDataManager-methoden

CHostDataManager-methoden De CHostDataManager-methoden leveren de parameters en retourwaarden voor het benaderen en besturen van CHostData-objecten.

CurrentDirectory() Retourneert de volledige padnaam van de huidige map waarin hostobjecten van pcAnywhere zijn opgeslagen. Zie Tabel 2-33 voor de definitie van de retourwaarde van CurrentDirectory. Tabel 2-33


Retourwaarde

Beschrijving

String


FindFirst(Pattern, Name string) Zoekt op basis van het opgegeven patroon van de bestandsnaam het eerste hostobjectbestand van pcAnywhere (*.bhf) in de huidige map op. Zie Tabel 2-34 voor een definitie van de FindFirst-parameters. Tabel 2-34

FindFirst-parameters

Parameter

Beschrijving

Pattern as string


Name as string

Retourbuffer voor de volledige padnaam van het hostobjectbestand dat overeenkomt met het opgegeven patroon.

Zie Tabel 2-35 voor de definitie van de retourwaarde van FindFirst. Tabel 2-35

FindFirst-retourwaarde

Retourwaarde

Beschrijving

Boolean

TRUE als een hostobjectbestand wordt gevonden dat overeenkomt met het opgegeven patroon. De volledige padnaam van het overeenkomende bestand wordt in Name opgeslagen.

Definities van Visual Basic-objecten CHostDataManager-methoden

FindNext(Name) Nadat FindFirst() is aangeroepen om de naam van een hostobjectbestand in de huidige map op te halen, kan FindNext() worden aangeroepen om het eventuele volgende bestand met een overeenkomend patroon te vinden. Zie Tabel 2-36 voor een definitie van de parameter FindNext. Tabel 2-36

FindNext-parameter

Parameter

Beschrijving

Name as string

Retourbuffer voor de volledige padnaam van het hostobjectbestand dat overeenkomt met het patroon dat in de eerste oproep voor FindFirst() is opgegeven.

Zie Tabel 2-37 voor de definitie van de retourwaarde van FindNext. Tabel 2-37

FindNext-retourwaarde

Retourwaarde

Beschrijving

Boolean

TRUE als een ander hostobjectbestand is gevonden dat overeenkomt met het patroon dat in de oproep voor FindFirst() is opgegeven. De volledige padnaam van het overeenkomende bestand wordt in Name opgeslagen.

RetrieveObject(Name, AccessMode, Password) Haalt een CHostData-object op bestandsnaam op. Zie Tabel 2-38 voor een definitie van de RetrieveObject-parameters. Tabel 2-38

RetrieveObject-parameters

Parameter

Beschrijving

Name as string

De naam van het te laden, volledig gekwalificeerde hostobjectbestand.



Password as string

■

0 = Niet opgegeven

■


■


■

3 = Uitvoeren


37


Zie Tabel 2-39 voor de definitie van de retourwaarde van RetrieveObject. Tabel 2-39

RetrieveObject-retourwaarde

Retourwaarde

Beschrijving

Object

CHostData-object uit het opgegeven bestand.

RetrieveObjectEx(Name, AccessMode, Password) Haalt een CHostDataEx-object op bestandsnaam op. Zie Tabel 2-40 voor een definitie van de RetrieveObjectEx-parameters. Tabel 2-40

RetrieveObjectEx-parameters

Parameter

Beschrijving

Name as string




Password as string

■

0 = Niet opgegeven

■


■


■

3 = Uitvoeren


Zie Tabel 2-41 voor de definitie van de retourwaarde van RetrieveObjectEx. Tabel 2-41

RetrieveObjectEx-retourwaarde

Retourwaarde

Beschrijving

Object

CHostDataEx-object uit het opgegeven bestand.

Definities van Visual Basic-objecten CHostDataManager-methoden

CreateObject(Name) Maakt een CHostData-object en retourneert een LPDISPATCH-pointer naar dit object. Zie Tabel 2-42 voor een definitie van de parameter CreateObject. Tabel 2-42

CreateObject-parameter

Parameter

Beschrijving

Name as string

De naam van het volledig gekwalificeerde hostobjectbestand voor het nieuwe object

Zie Tabel 2-43 voor de definitie van de retourwaarde van CreateObject. Tabel 2-43

CreateObject-retourwaarde

Retourwaarde

Beschrijving

Object

CHostData

CreateObjectEx(Name) Maakt een CHostDataEx-object en retourneert een LPDISPATCH-pointer naar dit object. Zie Tabel 2-44 voor een definitie van de parameter CreateObjectEx. Tabel 2-44

CreateObjectEx-parameter

Parameter

Beschrijving

Name as string


Zie Tabel 2-45 voor de definitie van de retourwaarde van CreateObjectEx. Tabel 2-45

CreateObjectEx-retourwaarde

Retourwaarde

Beschrijving

Object

CHostDataEx

39


DeleteObject(Name, Password) Verwijdert een hostobjectbestand. Zie Tabel 2-46 voor een definitie van de DeleteObject-parameters. Tabel 2-46

DeleteObject-parameters

Parameter

Beschrijving

Name as string

De naam van het volledig gekwalificeerde hostobjectbestand van het te verwijderen object.

Password as string

Objectwachtwoord.

Zie Tabel 2-47 voor de definitie van de retourwaarde van DeleteObject. Tabel 2-47

DeleteObject-retourwaarde

Retourwaarde

Beschrijving

Boolean


Launch(Name) Start een hostobjectbestand dat het hostterminalvenster van pcAnywhere opent. Zie Tabel 2-48 voor een definitie van de parameter Launch. Tabel 2-48

Launch-parameter

Parameter

Beschrijving

Name as string

De naam van het volledig gekwalificeerde hostobjectbestand van het te starten object.

Zie Tabel 2-49 voor de definitie van de retourwaarde van Launch. Tabel 2-49

Launch-retourwaarde

Retourwaarde

Beschrijving

Boolean

TRUE als het object met succes is gestart.

Definities van Visual Basic-objecten CHostData-eigenschappen

CHostData-eigenschappen Zie Tabel 2-50 voor een beschrijving van de eigenschappen en parameters die beschikbaar zijn voor het CHostData-object. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-50

Eigenschappen en parameters voor CHostData

Eigenschap


.PhoneNumber(String)

String

Stelt het telefoonnummer van de hostcomputer in.

.UseDialingProperties(Bool)

Bool

Stelt de kieseigenschappen van het systeem in.

.RedialCount(Integer)

Integer

Stelt in hoeveel keer wordt geprobeerd te bellen voordat de oproep wordt geannuleerd.

.RedialDelay(Integer)

Integer

Geeft op hoeveel seconden moet worden gewacht tussen de pogingen.

.Password(String)

String

Stelt het wachtwoord op het hostobject in voor gebruik bij de ExecuteProtection-, ReadProtection- en WriteProtection-instellingen. Uit het oogpunt van veiligheid wordt door de pcAnywhere Automation Server het wachtwoord niet als normale tekst weergegeven. De waarde van het wachtwoord wordt niet geretourneerd.

.ExecuteProtection(Bool)

Bool

Stelt in dat een wachtwoord nodig is om het object te kunnen uitvoeren. Geef een wachtwoord op.

.ReadProtection(Bool)

Bool

Stelt in dat een wachtwoord nodig is om de eigenschappen van het hostbject te kunnen bekijken. Geef een wachtwoord op.

.WriteProtection(Bool)

Bool

Stelt in dat een wachtwoord nodig is om de wijzigingen aan het hostobject te kunnen opslaan. Geef een wachtwoord op.

.LogSession(Bool)

Bool

Activeert en deactiveert sessie-aanmeldingen.

.RecordFile(String)

String

Stelt het volledig gekwalificeerde pad naar en de naam van de locatie van het bestand in waarin de actieve sessie wordt opgeslagen.

.RecordSession(Bool)

Bool

Activeert en deactiveert het automatisch opnemen van sessies.

.ReadObject(String)

String

Stelt het wachtwoord voor het object in. U kunt deze eigenschap gebruiken voor het vernieuwen van de lokale gegevenskopie van het hostobject.

41

42 Definities van Visual Basic-objecten CHostData-eigenschappen

Tabel 2-50

Eigenschappen en parameters voor CHostData

Eigenschap


.WriteObject(String)

String

Stelt het wachtwoord voor het object in. Gebruik deze eigenschap voor het maken van het hostobject of het opslaan van wijzigingen die u in het hostobject hebt aangebracht.

Zie Tabel 2-51 voor een beschrijving van de eigenschappen en retourwaarden voor CHostData. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen.. Tabel 2-51

Eigenschappen en retourwaarden voor CHostData

Eigenschap

Retourwaarde

Beschrijving

String = .PhoneNumber

String

Retourneert het telefoonnummer van de hostcomputer.

Bool = .UseDialingProperties

Bool

Retourneert het gebruik van de kieseigenschappen van het systeem die in het hostobject zijn ingesteld.

Integer = .RedialCount

Integer

Retourneert het aantal pogingen om opnieuw te bellen dat is ingesteld in het hostobject.

Integer = .RedialDelay

Integer

Retourneert het aantal seconden tussen de pogingen om opnieuw te bellen.

Bool = .ExecuteProtection

Bool

Retourneert de waarde van de ExecuteProtectioninstelling

Bool = .ReadProtection

Bool

Retourneert de waarde van de ReadProtectioninstelling.

Bool = .WriteProtection

Bool

Retourneert de waarde van de WriteProtectioninstelling.

Bool = .LogSession

Bool

Retourneert TRUE als sessie-aanmelding is ingeschakeld.

String = .RecordFile

String

Retourneert het volledige gekwalificeerde pad naar en de naam van het sessieopnamebestand.

Bool = .RecordSession

Bool

Retourneert de waarde van de opname-instelling voor de sessie.


Eigenschappen van het verbindingstype Zie Tabel 2-52 voor een beschrijving van de eigenschappen en parameters van het verbindingstype. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-52

Eigenschappen en parameters van het verbindingstype

Eigenschap


.ConnectionType(String)

String

Stelt het verbindingstype van de host in. De opgegeven waarde moet een geldig verbindingstype zijn zoals wordt gedefinieerd door de functies FirstConnectionType() en NextConnectionType(). Hieronder staan enkele voorbeelden van geldige verbindingstypen: ■

COM1

■

COM2

■

COM3

■

COM4

■

LPT1

■

LPT2

■

LPT3

■

LPT4

■

TCP/IP

■

SPX

■

NetBIOS

■

Infrarood

■

ISDN via CAPI 2.0

■


.AssignConnection(String)

String

Stelt het verbindingstype dat in de string is gedefinieerd, in op de actieve status.

.UnassignConnection(String)

String

Stelt het verbindingstype dat in de string is gedefinieerd, in op de inactieve status.

43


Zie Tabel 2-53 voor een beschrijving van de eigenschappen en retourwaarden van het verbindingstype. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-53


Eigenschap

Retourwaarde

Beschrijving

String = .ConnectionTypes

String

Retourneert het verbindingstype van het hostobject.

Integer = .ConnectionType

Integer

Retourneert het aantal beschikbare verbindingstypen. Hieronder staan enkele voorbeelden van geldige verbindingstypen: ■

COM1

■

COM2

■

COM3

■

COM4

■

LPT1

■

LPT2

■

LPT3

■

LPT4

■

TCP/IP

■

SPX

■

NetBIOS

■

Infrarood

■

ISDN via CAPI 2.0

■


String = .FirstConnectionType

String

Retourneert het eerste beschikbare verbindingstype.

String = .NextConnectionType

String

Retourneert het volgende beschikbare verbindingstype. De verbindingstypen worden opeenvolgend op nummers opgehaald die in .ConnectionType zijn ingesteld voor het opeenvolgend nummeren van alle verbindingstypen.

Bool = .FindConnectionType (ConnectionType)

Bool

Retourneert TRUE als het betreffende verbindingstype in de lijst met beschikbare verbindingstypen staat.


Tabel 2-53


Eigenschap

Retourwaarde

Beschrijving

Integer = .MaxAssignedConnections

Integer

Retourneert het maximumaantal verbindingstypen dat op deze host actief kan zijn.

String = .FirstAssignedConnection

String

Retourneert het eerste, toegewezen actieve verbindingstype.

String = .NextAssignedConnection

String

Retourneert het volgende, toegewezen actieve verbindingstype.

Bool = .FindAssignedConnection (ConnectionType)

Bool

Retourneert TRUE als het opgegeven verbindingstype overeenkomt met een van de actieve verbindingstypen.

AssignConnection(ConnectionType) method De methode AssignConnection(Connection Type) plaatst het gevraagde verbindingstype in de lijst met toegewezen verbindingstypen van het hostobject en maakt dit het huidige verbindingstype bij het verwerken van volgende apparaatspecifieke methodeoproepen. Als het aangevraagde verbindingstype al in de lijst met toegewezen verbindingen staat, verandert deze lijst niet. Alleen het huidige verbindingstype wordt gewijzigd in het aangevraagde type. Het is normaal om de AssignConnectionmethode meerdere keren op hetzelfde object aan te roepen bij het ophalen en instellen van verbindingsspecifieke waarden. AssignConnection retourneert TRUE als het opgegeven verbindingstype op de computer staat en met succes is toegewezen of al was toegewezen. FALSE wordt geretourneerd als het gevraagde verbindingstype niet op de computer staat of als het maximale aantal toegewezen verbindingen is bereikt. Het hostobject van pcAnywhere ondersteunt maximaal twee toegewezen verbindingstypen. De AssignConnection-methode retourneert FALSE als iemand een poging doet de grens te overschrijden. Zie Tabel 2-54 voor de definitie van de AssignConnection-parameter. Tabel 2-54

AssignConnection-parameter

Parameter

Beschrijving

ConnectionType as string

De naam van een toe te wijzen type verbindingsapparaat.

45


Zie Tabel 2-55 voor de definitie van de retourwaarde van AssignConnection. Tabel 2-55

AssignConnection-retourwaarde

Retourwaarde

Beschrijving

Boolean

TRUE als dit apparaattype beschikbaar is en het maximaal toegestane aantal verbindingen nog niet is bereikt.

UnassignConnection(ConnectionType)-methode De methode UnassignConnection(Connection Type) retourneert TRUE als het opgegeven verbindingstype is verwijderd uit de lijst met toegewezen verbindingstypen. Zie Tabel 2-56 voor de definitie van de UnassignConnection-parameter. Tabel 2-56

UnassignConnection-parameter

Parameter

Beschrijving

ConnectionType as string

De naam van een type verbindingsapparaat waarvan de toewijzing moet worden opgeheven.

Zie Tabel 2-57 voor de definitie van de retourwaarde van UnassignConnection. Tabel 2-57

UnassignConnection-retourwaarde

Retourwaarde

Beschrijving

Boolean

TRUE als de toewijzing van dit apparaattype met succes is opgeheven.

Kieseigenschappen Zie Tabel 2-58 voor de definities en retourwaarden voor het instellen van de kieseigenschappen voor modemverbindingen. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-58

Eigenschappen en parameters voor kieseigenschappen van modems

Eigenschap


.AreaCode(String)

String

Stelt het kengetal voor de modemverbindingen in.

.CountryCode(String)

String

Stelt het landnummer voor modemverbindingen in.


Zie Tabel 2-59 voor de definities van de eigenschappen en retourwaarden voor de kieseigenschappen van modems. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-59

Eigenschappen en retourwaarden voor kieseigenschappen van modems

Eigenschap

Retourwaarde

Beschrijving

String = .AreaCode

String

Retourneert het kengetal.

String = .CountryCode

String

Retourneert het landnummer.

Integer = .CountryCodes

Integer

Retourneert het aantal beschikbare landnummers.

String= .FirstCountryCode

String

Retourneert het eerste beschikbare landnummer uit het besturingssysteem.

String = .NextCountryCode

String

Retourneert het volgende beschikbare landnummer. De landnummers worden opeenvolgend op nummers opgehaald die in .CountryCodes zijn ingesteld voor het opeenvolgend nummeren van alle verbindingstypen.

COM-apparaateigenschappen Zie Tabel 2-60 voor de definities van de eigenschappen en parameters waarmee u de poortinstellingen voor modemverbindingen en andere COM-verbindingen kunt aanpassen. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-60


Eigenschap


.ComParity(String)

String

Stelt de communicatiepariteit in. De volgende waarden zijn geldige waarden: ■

■

Oneven

■

Even

■

Markeer

■

Spatie

47


Tabel 2-60


Eigenschap


.ComFlowControl(String)

String

Stelt het gegevenstransport via COMverbindingen in. De volgende waarden zijn geldige waarden:

.ComStartedBy(String)

String

■

■

XONXOFF

■

RTS/CTS

■

Beide

Stelt de begininstelling van COM-verbindingen in. De volgende waarden zijn geldige waarden:

.ComEndedBy(String)

String

■

Altijd verbinding

■


■

Clear to send (CTS)

■


■

Ring indicator (RI)

■

2 's ontvangen

■

Modemrespons

Stelt de eindinstelling van COM-verbindingen in. De volgende waarden zijn geldige waarden:

.ComSpeed(Long)

Lang

■

Altijd verbinding

■


■

Clear to send (CTS)

■


■

Ring indicator (RI)

Stelt de maximumsnelheid voor de COMverbinding in. De volgende waarden zijn geldige waarden: ■

110

■

300

■

600

■

1200

■

2400

■

4800

■

9600

■

38400

■

57600

■

115200


Zie Tabel 2-61 voor een beschrijving van de eigenschappen en retourwaarden van COM-apparaten. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-61


Eigenschap

Retourwaarde

Beschrijving

String = .ComParity

String

Retourneert een van de volgende waarden als de communicatiepariteit:

String = .ComFlowControl

String

■

■

Oneven

■

Even

■

Markeer

■

Spatie

Retourneert de instellingen van het communicatietransport van het hostobject. De volgende waarden zijn geldige waarden:

String = .ComStartedBy

String

■

■

XONXOFF

■

RTS/CTS

■

Beide

Retourneert de beginbesturing van de communicatie van COM-verbindingen. De volgende waarden zijn geldige waarden:

String = .ComEndedBy

String

■

Altijd verbinding

■


■

Clear to send (CTS)

■


■

Ring indicator (RI)

■

2 's ontvangen

■

Modemrespons

Retourneert de eindbesturing van de communicatie van COM-verbindingen. De volgende waarden zijn geldige waarden: ■

Altijd verbinding

■


■

Clear to send (CTS)

■


■

Ring indicator (RI)

49


Tabel 2-61


Eigenschap

Retourwaarde

Beschrijving

Long = .ComSpeed

Lang

Retourneert de huidige instelling van de communicatiesnelheid van het hostobject. De volgende waarden zijn geldige waarden: ■

110

■

300

■

600

■

1200

■

2400

■

4800

■

9600

■

38400

■

57600

■

115200

Eigenschappen van NetBIOS-apparaat Zie Tabel 2-62 voor de definitie van de eigenschap en parameter voor NetBIOSnetwerkapparaten. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-62

NetBIOS-eigenschap en parameter

Eigenschap


.LanaNumber(Integer)

Integer

Stelt het nummer van de LAN-adapter (LANA) voor NetBIOS-verbindingen in.

Zie Tabel 2-63 voor de definitie van de eigenschap en retourwaarde voor NetBIOS-netwerkapparaten. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-63

NetBIOS-retourwaarden

Eigenschap

Retourwaarde

Beschrijving

Integer = .LanaNumber

Integer

Retourneert de huidige instelling van het nummer van de LAN-adapter (LANA) voor NetBIOSverbindingen.


ISDN via CAPI 2.0-apparaateigenschappen Zie Tabel 2-64 voor de definitie van de eigenschappen en parameters voor Europese ISDN-verbindingen. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-64

Eigenschappen en parameters van ISDN via CAPI 2.0

Eigenschap


.CapiChannelBonding(Bool)

Bool

Activeert en deactiveert de kanaalverbinding voor ISDN CAPI-apparaten.

.CapiExtensions(String)

String

Stelt alle extra CAPI-extensies in die nodig zijn voor de communicatie.

Zie Tabel 2-65 voor de definitie van de eigenschappen en retourwaarden voor Europese ISDN-verbindingen. Tabel 2-65

Eigenschappen en retourwaarden van ISDN via CAPI 2.0

Eigenschap

Retourwaarde

Beschrijving

Bool= .CapiChannelBonding

Bool

Retourneert de instelling van de huidige ISDN CAPI-kanaalverbinding in het hostobject.

String = .CapiExtensions

String

Retourneert de huidige lijst met CAPI-extensies van het hostobject.

Eigenschappen van netwerkapparaat (TCP/IP, SPX) voor gateways U kunt de volgende eigenschappen alleen met pcAnywhere 9.2x gebruiken: ■

GatewayUse as boolean

■

GatewayName as string

■

GatewayClass as string

■

GatewayParity as string

Opmerking: nieuwere versies van pcAnywhere ondersteunen de gatewayfunctionaliteit niet meer.

51

52 Definities van Visual Basic-objecten CHostDataEx-object

CHostDataEx-object Het CHostDataEx-object heeft dezelfde functies als het CHostData-object plus een aantal andere functies. Zie Tabel 2-66 voor een beschrijving van de eigenschappen en parameters. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-66

Eigenschappen en parameters voor CHostDataEx

Eigenschap


.CryptPrivateKey(String)

String

Stelt de naam van de te gebruiken container eigen sleutel in.

.CryptCommonName(String)

String

Stelt de algemene naam van de te gebruiken eigen sleutel in.

.CryptReqLevel(Byte)

Byte

Stelt het coderingsniveau in. De volgende waarden zijn geldige waarden: ■

-1: Geen

■

0: pcAnywhere

■

1: Symmetrisch

■

2: Openbare sleutel

.CryptRefuseLower(Bool)

Bool

Definieert of vanaf de hostcomputer een verbinding mogelijk is met een externe computer waarop een lager coderingsniveau wordt gebruikt.

.CallersPath(String)

String

Stelt het volledig gekwalificeerde pad naar de bellerbestanden in.

.ConfirmConnect(Bool)

Bool

Bepaalt of de hostgebruiker wordt gevraagd de verbindingen te bevestigen.

.ConfirmTimeout(Byte)

Byte

Stelt het aantal seconden in waarna de vraag voor het bevestigen van de verbinding verloopt.

.ConfirmDeny(Bool)

Bool

Bepaalt of de verbinding moet worden beëindigd als de vraag voor het bevestigen van de verbinding verloopt.

.PwCaseSensitive(Bool)

Bool

Alleen wachtwoorden met onderscheid tussen hoofdletters en kleine letters mogen worden gebruikt.

.PwAttempts(Byte)

Byte

Stelt in hoeveel keer mag worden geprobeerd aan te melden voordat de verbinding wordt verbroken.

Definities van Visual Basic-objecten CHostDataEx-object

Tabel 2-66


Eigenschap


.PwTimeout(Byte)

Byte

Stelt het aantal minuten in waarbinnen de gebruiker zich moet hebben aangemeld voordat de verbinding wordt verbroken.

.ActiveKbds(Byte)

Byte

Bepaalt welke muis en welk toetsenbord tijdens de verbinding kunnen worden gebruikt. De volgende waarden zijn geldige waarden: ■

0: Host en extern

■

1: Host

■

2: Extern

.InactiveTimeout(Byte)

Byte

Stelt in hoeveel minuten het toetsenbord en de muis inactief kunnen zijn voordat de verbinding wordt verbroken.

.LockSystemWhileWait(Bool)

Bool

Stelt de vergrendelingsinstelling voor de hostcomputer bij opstarten in.

.MinimizeOnLaunch(Bool)

Bool

Stelt de optie voor het opstarten van de host als pictogram in.

.RunAsService(Bool)

Bool

Laat de host als een service uitvoeren.

.ConnLostWait(Byte)

Byte

Stelt in na hoeveel minuten een andere beller verbinding kan maken.

.ConnLostHostOpts(Bool)

Bool

Bepaalt bij een abnormale beëindiging van de sessie of wordt gewacht op een andere verbinding of dat de host wordt geannuleerd. De volgende waarden zijn geldige waarden:

.EnableConnLostSecurity(Bool)

Bool

■

FALSE: Wachten

■

TRUE: Host annuleren

Activeert of deactiveert het einde van de sessiebeveiligingsopties voor sessies die niet op een normale manier zijn beëindigd.

53


Tabel 2-66


Eigenschap


.AuthenticationType(Byte)

Byte

Stelt het verificatietype in. De volgende waarden zijn geldige waarden: ■

0: pcAnywhere

■

1: pcAnywhere

■

2: Windows

■

3: NT

■

4: pcAnywhere

■

5: pcAnywhere

■

6: ADS Active Directory Services

■

7: Microsoft LDAP

■

8: FTP

■

9: HTTP

■

10: HTTPS

■

11: Netscape LDAP

■

12: Novell LDAP

■

13: RSA SecurID

De pcAnywhere-verificatie wordt standaard gebruikt als geen verificatiewaarde is ingesteld of als de ingestelde waarde niet geldig is, omdat bijvoorbeeld het verificatietype niet beschikbaar is. .ConnLostSecurity(Byte)

Byte

Stelt de beveiligingsopties voor het afhandelen van een abnormaal einde van een sessie in. De volgende waarden zijn geldige waarden: ■

1: Gebruiker afmelden

■

2: Hostcomputer opnieuw opstarten

■

3: Computer vergrendelen

.CallbkDelay(Byte)

Byte

Stelt in na hoeveel seconden de hostmodem de externe modem terugbelt.

.EndSessHostOpts(Bool)

Bool

Bepaalt of de host op een andere verbinding wacht of wordt geannuleerd als de sessie op een normale manier is beëindigd. De volgende waarden zijn geldige waarden:

.EnableEndSessSecurity(Bool)

Bool

■

FALSE: Op volgende verbinding wachten

■


Activeert of deactiveert de beveiligingsopties voor een normaal einde van de sessie.


Tabel 2-66


Eigenschap


.EndSessSecurity(Byte)

Byte

Stelt de beveiligingsopties voor een normaal einde van een sessie in. De volgende waarden zijn geldige waarden: ■


■


■


.BlankHost(Bool)

Bool

Stelt in dat het scherm op de hostcomputer wordt leeggemaakt. Niet alle videokaarten ondersteunen deze optie.

.AllowRemoteMouse(Bool)

Bool

Schakelt het gebruik van de muis op de externe computer gedurende de duur van een sessie uit.

.RebootOnDisconnect(Bool)

Bool

Bij TRUE wordt de computer aan het einde van een sessie opnieuw opgestart.

.PasswordAfterDisc(Bool)

Bool

Meldt de gebruiker af nadat de sessie is beëindigd.

.LogFailures(Bool)

Bool

Legt invoer van verkeerde wachtwoorden vast.

.AllowDriveSecurity(Bool)

Bool

Schakelt de beveiligingsopties voor stations in. Deze instelling werkt alleen op NTFSbestandssystemen.

.UseDirectoryServices(Bool)

Bool

Schakelt het gebruik van directoryservices voor verificatie in.

.DirectoryServiceEntry(String)

String

Stelt de instellingen van de directoryservices in.

Zie Tabel 2-67 voor een beschrijving van de eigenschappen en retourwaarden voor het CHostDataEx-object. De gegevens tussen punthaken moeten door de eigenlijke waarden worden vervangen. Tabel 2-67

Eigenschappen en retourwaarden voor CHostDataEx

Eigenschap

Retourwaarde

Beschrijving

String = .CryptPrivateKey

String

Retourneert de huidige, actieve container eigen sleutel.

String = .CryptCommonName

String

Retourneert de algemene naam van de actieve container eigen sleutel.

55


Tabel 2-67


Eigenschap

Retourwaarde

Beschrijving

Byte = .CryptReqLevel

Byte

Retourneert een van de volgende coderingsniveaus: ■

-1: Geen

■

0: pcAnywhere

■

1: Symmetrisch

■

2: Openbare sleutel

Bool = .CryptRefuseLower

Bool


String = .CallersPath

String

Retourneert het huidige, actieve pad naar de bellerbestanden.

Bool = .ConfirmConnect

Bool

Retourneert de waarde van de instelling voor het bevestigen van de verbinding.

Byte = .ConfirmTimeout

Byte


Bool = .ConfirmDeny

Bool

Retourneert de waarde van de instelling om bij verstrijken van de tijd de verbinding te verbreken.

Bool = .PwCaseSensitive

Bool

Retourneert de waarde van de instelling om wachtwoorden hoofdlettergevoelig te maken.

Byte = .PwAttempts

Byte

Retourneert de waarde van de instelling voor het aantal aanmeldpogingen per oproep.

Byte = .PwTimeout

Byte

Retourneert de waarde van de instelling voor de tijd (in minuten) waarbinnen de aanmelding moet zijn uitgevoerd.

Byte = .ActiveKbds

Byte

Retourneert de instellingen voor een actief toetsenbord en een actieve muis. De volgende waarden zijn geldige waarden: ■

0: Host en extern

■

1: Host

■

2: Extern

Byte = . Inactieve time-out

Byte

Retourneert het aantal minuten van inactiviteit waarna de verbinding wordt verbroken.

Bool = .LockSystemWhileWait

Bool

Retourneert de instelling voor de vergrendeling van de hostcomputer bij opstarten.


Tabel 2-67


Eigenschap

Retourwaarde

Beschrijving

Bool = .MinimizeOnLaunch

Bool

Retourneert de instelling voor het starten van de host als pictogram.

Bool = .RunAsService

Bool

Retourneert de instelling voor het uitvoeren van de host als een service.

Byte = .ConnLostWait

Byte

Retourneert het aantal minuten dat moet worden gewacht voordat een andere verbinding tot stand mag worden gebracht.

Bool = .ConnLostHostOpts

Bool

Retourneert of bij een abnormale beëindiging van de sessie wordt gewacht op een andere verbinding of dat de host wordt geannuleerd. De volgende waarden zijn geldige waarden:

Bool = .ConnLostWait

Bool

■

FALSE: Wachten

■


Retourneert de waarde van de beveiligingsoptie die is ingesteld voor het afhandelen van een abnormaal einde van een sessie.

57


Tabel 2-67


Eigenschap

Retourwaarde

Beschrijving

Byte = .AuthenticationType

Byte

Retourneert de nummerreferentie van het verificatietype. De volgende waarden zijn geldige waarden: ■

0: pcAnywhere

■

1: pcAnywhere

■

2: Windows

■

3: NT

■

4: pcAnywhere

■

5: pcAnywhere

■

6: ADS Active Directory Services

■

7: Microsoft LDAP

■

8: FTP

■

9: HTTP

■

10: HTTPS

■

11: Netscape LDAP

■

12: Novell LDAP

■

13: RSA SecurID

De pcAnywhere-verificatie wordt standaard gebruikt als geen verificatiewaarde is ingesteld of als de ingestelde waarde niet geldig is, omdat bijvoorbeeld het verificatietype niet beschikbaar is. Byte = .ConnLostSecurity

Byte

Retourneert de numerieke weergave van het beveiligingsniveau dat is ingesteld voor het afhandelen van een abnormaal einde van een sessie. De volgende waarden zijn geldige waarden:

Byte = .CallbkDelay

Byte

■


■


■


Retourneert het aantal seconden dat wordt gewacht voordat de hostmodem de externe modem terugbelt.


Tabel 2-67


Eigenschap

Retourwaarde

Beschrijving

Bool = .EndSessHostOpts

Bool

Retourneert of de host op een andere verbinding wacht of wordt geannuleerd als de sessie op een normale manier is beëindigd. De volgende waarden zijn geldige waarden: ■

FALSE: Op volgende verbinding wachten

■


Bool = .EnableEndSessSecurity

Bool

Retourneert of de beveiligingsopties voor de sessie-beëindiging zijn ingeschakeld voor een normaal einde van een sessie.

Byte = .EndSessSecurity

Byte

Retourneert de beveiligingsoptie die is ingesteld voor een normaal einde van een sessie. De volgende waarden zijn geldige waarden: ■


■


■


Bool = .BlankHost

Bool

Retourneert de ingestelde optie voor het leegmaken van het scherm.

Bool = .AllowRemoteMouse

Bool

Retourneert of de externe gebruiker het toetsenbord en de muis tijdens een sessie kan gebruiken.

Bool = .RebootOnDisconnect

Bool

Retourneert of de hostcomputer na het beëindigen van de sessie opnieuw wordt opgestart.

Bool = .PasswordAfterDisc

Bool

Retourneert of de hostgebruiker na het beëindigen van de sessie wordt afgemeld.

Bool = .LogFailures

Bool

Retourneert of de optie voor het vastleggen van verkeerde aanmeldwachtwoorden is ingesteld.

Bool = .AllowDriveSecurity

Bool

Retourneert of de stationsbeveiligingsoptie is ingeschakeld.

Bool = .UseDirectoryServices

Bool

Retourneert of de directoryservicesoptie is ingeschakeld.

String = .DirectoryServiceEntry

String

Retourneert de directoryservice-instellingen.

59


Voorbeeld van Visual Basic-code voor hostfunctionaliteit In de volgende voorbeelden met Visual Basic-codes wordt een hostgegevensobject opgehaald en worden de eigenschappen van dat object gewijzigd: Private Sub Command1_Click() Dim HostDataManager as Object Dim HostData as Object Dim s as string 'CHostDataManager-object maken Set HostDataManager = CreateObject(WINAWSVR.BEHOSTDATAMANAGER) 'huidige map weergeven en wijzigen s = HostDataManager.CurrentDirectory() MsgBox (s) HostDataManager.ChangeDirectory ("C:\dev\bin.w32\data") s = HostDataManager.CurrentDirectory() MsgBox (s) 'externe-gegevensobject ophalen Set HostData = HostDataManager.RetrieveObject("pod.BHF", 2, 0) 'enkele eigenschappen weergeven s = HostData.AreaCode() MsgBox (s) s = HostData.PhoneNumber() MsgBox (s) 'enkele eigenschappen instellen RemoteData. HostData = "212" RemoteData. HostData = "555-5555" 'object naar schijf schrijven HostData.WriteObject (0) End Sub

Definities van Visual Basic-objecten Awrem32-functies

Gebruik de methoden FindFirst en FindNext om het hostbestand als volgt in een map weer te geven. Private Sub Command5_Click() Dim HostDataManager as Object Dim HostData as Object Dim s as string Set HostDataManager = CreateObject("WINAWSVR.BEHOSTDATAMANAGER") HostDataManager.ChangeDirectory ("C:\dev\bin.w32\data") HostDataManager.FindFirst "*", s MsgBox (s) HostDataManager.FindNext s MsgBox (s) End Sub

Awrem32-functies De Awrem32-functies leveren de parameters en retourwaarden voor het afhandelen van verbindingen tussen de hostcomputer en de externe computer.

awConnect(FileName) Maakt de verbinding met de hostcomputer. Zie Tabel 2-68 voor de definitie van de awConnect-parameter. Tabel 2-68

awConnect-parameter

Parameter

Beschrijving

Name as string

De naam van het volledig gekwalificeerde chf-bestand dat informatie over de hostcomputer bevat.

Zie Tabel 2-69 voor de definitie van de retourwaarde van awConnect. Tabel 2-69

awConnect-retourwaarde

Retourwaarde

Beschrijving

Boolean

TRUE als opdracht wordt uitgevoerd.

61

62 Definities van Visual Basic-objecten Awrem32-functies

awDisconnect() Verbreekt de verbinding met de hostcomputer. Zie Tabel 2-70 voor de definitie van de retourwaarde. Tabel 2-70

awDisconnect()-retourwaarde

Retourwaarde

Beschrijving

Boolean

Nadat deze functie is aangeroepen, moet het aanroepende programma het object verwijderen (C++ - delete IAwrem32X*, VB – set ObjectName = Nothing;).

FileXferFromHost(HostFile, RemoteFile) Kopieert een bestand van de hostcomputer naar de externe computer. De parameters kunnen jokertekens bevatten. Zie Tabel 2-71 voor de definitie van de FileXferFromHost-parameters. Tabel 2-71

FileXferFromHost-parameters

Parameter

Beschrijving

HostFile as string

Bevat de naam van het volledig gekwalificeerde pad en bestand die vanaf de hostcomputer moeten worden gekopieerd.

RemoteFile as string

Bevat de naam van het volledig gekwalificeerde doelpad en bestand. De strings HostFile en RemoteFile hoeven niet gelijk aan elkaar te zijn.

Zie Tabel 2-72 voor de definitie van de retourwaarde van FileXferFromHost. Tabel 2-72

FileXferFromHost-retourwaarde

Retourwaarde

Beschrijving

Boolean


Definities van Visual Basic-objecten Awrem32-functies

FileXferToHost(HostFile, RemoteFile) Kopieert een bestand van de externe computer naar de hostcomputer. De parameters kunnen jokertekens bevatten. Zie Tabel 2-73 voor de definitie van de FileXferToHost-parameters. Tabel 2-73

FileXferToHost-parameters

Parameter

Beschrijving

HostFile as string

Bevat de naam van het volledig gekwalificeerde doelpad en bestand.


Bevat de naam van het volledig gekwalificeerde pad en bestand die vanaf de externe computer moeten worden gekopieerd. De strings HostFile en RemoteFile hoeven niet gelijk aan elkaar te zijn.

Zie Tabel 2-74 voor de definitie van de retourwaarde van FileXferToHost. Tabel 2-74

FileXferToHost-retourwaarde

Retourwaarde

Beschrijving

Boolean


CreateFolderOnHost(FolderName) Maakt een nieuwe map op de hostcomputer. Op de externe computer wordt een tijdelijke map gemaakt, die vervolgens naar de host wordt gekopieerd. Zie Tabel 2-75 voor de definitie van de CreateFolderOnHost-parameter. Tabel 2-75

CreateFolderOnHost-parameter

Parameter

Beschrijving

FolderName as string

Bevat het station en pad voor de map die op de hostcomputer wordt gemaakt.

Zie Tabel 2-76 voor de definitie van de retourwaarden van CreateFolderOnHost. Tabel 2-76

CreateFolderOnHost-retourwaarden

Retourwaarde

Beschrijving

Boolean


63

64 Definities van Visual Basic-objecten Awrem32-functies

ExecuteHostFile(FileName) Voert een bestaand bestand op de hostcomputer uit. Deze functie voert alleen batch- en opdrachtbestanden en uitvoerbare bestanden uit. Uitvoerbare bestanden die aan bestanden zijn gekoppeld, worden niet uitgevoerd. Als u bijvoorbeeld een doc-bestand uitvoert, wordt Microsoft Word niet gestart. Zie Tabel 2-77 voor de definitie van de ExecuteHostFile-parameter. Tabel 2-77

ExecuteHostFile-parameter

Parameter

Beschrijving

FileName as string

Bevat het volledig gekwalificeerde pad naar het bestand op de hostcomputer.

Zie Tabel 2-78 voor de definitie van de retourwaarde van ExecuteHostFile. Tabel 2-78

ExecuteHostFile-retourwaarde

Retourwaarde

Beschrijving

Boolean


GetError() Retourneert de laatste fout als een string. Zie Tabel 2-79 voor de definitie van de retourwaarde. Tabel 2-79


Retourwaarde

Beschrijving

String

Retourneert de laatste fout die is opgetreden in Awrem32.

ConnectionStatus() Retourneert de huidige status van uw verbinding met de hostcomputer. Zie Tabel 2-80 voor de definitie van de retourwaarde. Tabel 2-80

ConnectionStatus()-retourwaarde

Retourwaarde

Beschrijving

Short

De mogelijke waarden zijn: ■

-1 = Verbinding is verbroken

■

0 = Geen verbinding

■

1 = Sessie is verbonden

Hoofdstuk

3

Definities van Visual C++objecten In dit hoofdstuk worden de volgende onderwerpen besproken: ■

Info over Visual C++-objecten

■

CRemoteDataManager-methoden

■

CRemoteData-object

■

CRemoteDataEx-object

■

CHostDataManager-methoden

■

CHostData-object

■

CHostDataEx-object

■

Awrem32-functies

Info over Visual C++-objecten De pcAnywhere Automation Server beschikt over de volgende onderdelen voor ondersteuning van OLE-automatisering: ■

Winawsvr: levert de gegevens die nodig zijn om verbinding te maken met pcAnywhere Automation Server en om de interfaces van deze server te benaderen.

■

Awrem32: levert de gegevens voor het besturen van de pcAnywhereverbindingen.

66 Definities van Visual C++-objecten Info over Visual C++-objecten

Winawsvr bestaat uit de objecten die worden beschreven in Tabel 3-1. Tabel 3-1

Winawsvr-objecten

Object

Beschrijving

Verwijzing

CRemoteDataManager

Levert de methoden voor het maken, openen, wijzigen, opslaan en verwijderen van CRemoteData-objecten.

Zie "CRemoteDataManagermethoden" op pagina 67.

CRemoteData

Definieert de parameters voor het benaderen en besturen van de externe functionaliteit van pcAnywhere.

Zie "CRemoteData-object" op pagina 73.

CHostDataManager

Levert de methoden voor het maken, openen, wijzigen, opslaan en verwijderen van CHostData-objecten.

Zie "CHostDataManagermethoden" op pagina 83.

CHostData

Definieert de parameters voor het benaderen en besturen van de hostfunctionaliteit van pcAnywhere.

Zie "CRemoteData-object" op pagina 73.



Awrem32 heeft één object dat bestaat uit acht interfaces voor ondersteuning van externe besturings- en bestandsverzendingssessies. Zie "Awrem32-functies" op pagina 103. Sommige functies, zoals de gatewayvoorziening, worden niet langer ondersteund. Voor gebruik met oudere versies worden echter objectdefinities geleverd. Zie "Eigenschappen van netwerkapparaat (TCP/IP, SPX) voor gateways" op pagina 93. Voor functies waarbij wachtwoorden zijn vereist, kunt u wachtwoorden instellen, maar niet ophalen. Dit is vanuit het oogpunt van de veiligheid gedaan.

Definities van Visual C++-objecten CRemoteDataManager-methoden

CRemoteDataManager-methoden De CRemoteDataManager-methoden leveren de parameters en retourwaarden voor het benaderen en besturen van CRemoteData-objecten.

BSTR CurrentDirectory(); Haalt de volledige padnaam van de huidige map op waarin externe objecten van pcAnywhere zijn opgeslagen. Zie Tabel 3-2 voor een definitie van de parameter. Tabel 3-2

BSTR CurrentDirectory(); parameter

Parameter

Beschrijving

BSTR


BOOL ChangeDirectory(LPCTSTR lpszNewDirectory); Wijzigt de huidige map waarin externe objecten van pcAnywhere zijn opgeslagen. Zie Tabel 3-3 voor een definitie van de parameter. Tabel 3-3

BOOL ChangeDirectory-parameter

Parameter

Beschrijving

LPCTSTR lpszNewDirectory


Zie Tabel 3-4 voor de definitie van de retourwaarde. Tabel 3-4

BOOL ChangeDirectory-retourwaarde

Retourwaarde

Beschrijving

BOOL

TRUE indien gelukt

67

68 Definities van Visual C++-objecten CRemoteDataManager-methoden

BOOL FindFirst(LPCTSTR lpszPattern, BSTR FAR* pbstrFullQualName); Vindt op basis van het opgegeven bestandsnaampatroon het eerste extern-objectbestand (*.chf) van pcAnywhere in de huidige map. Zie Tabel 3-5 voor een definitie van de parameters. Tabel 3-5

BOOL FindFirst-parameters

Parameter

Beschrijving

LPCTSTR lpszPattern


BSTR FAR * pbstrFullQualName

Retourbuffer voor de volledige padnaam van het extern-objectbestand dat overeenkomt met het opgegeven patroon.


BOOL FindFirst-retourwaarde

Retourwaarde

Beschrijving

BOOL

TRUE als een extern-objectbestand wordt gevonden dat overeenkomt met het opgegeven patroon. De volledige padnaam van het overeenkomende bestand wordt in pbstrFullQualName opgeslagen.

BOOL FindNext(BSTR FAR* pbstrFullQualName); Nadat FindFirst() is aangeroepen om de naam van een extern-objectbestand in de huidige map te plaatsen, kan FindNext() worden aangeroepen om het eventuele volgende bestand met een overeenkomend patroon te vinden. Zie Tabel 3-7 voor een definitie van de parameter. Tabel 3-7

BOOL FindNext-parameter

Parameter

Beschrijving


Retourbuffer voor de volledige padnaam van het extern-objectbestand dat overeenkomt met het patroon dat in de eerste oproep voor FindFirst() is opgegeven.



BOOL FindNext-retourwaarde

Retourwaarde

Beschrijving

BOOL

TRUE als een ander extern-objectbestand is gevonden dat overeenkomt met het patroon dat in de oproep voor FindFirst() is opgegeven. De volledige padnaam van het overeenkomende bestand wordt in pbstrFullQualName opgeslagen.

LPDISPATCH RetrieveObject(LPCTSTR lpszFQName, short wAccessMode, LPCTSTR lpszPassword); Haalt een CRemoteData-object op bestandsnaam op. Zie Tabel 3-9 voor een definitie van de parameters. Tabel 3-9

LPDISPATCH RetrieveObject-parameters

Parameter

Beschrijving

LPCTSTR lpszFQName


short wAccessMode


LPCTSTR lpszPassword

■

0 = Niet opgegeven

■


■


■

3 = Uitvoeren


LPDISPATCH RetrieveObjectEx(LPCTSTR lpszFQName, short wAccessMode, LPCTSTR lpszPassword); Haalt een CRemoteDataEx-object op bestandsnaam op. Zie Tabel 3-10 voor een definitie van de parameters. Tabel 3-10

LPDISPATCH RetrieveObjectEx-parameters

Parameter

Beschrijving

LPCTSTR lpszFQName


69


Tabel 3-10


Parameter

Beschrijving

short wAccessMode



■

0 = Niet opgegeven

■


■


■

3 = Uitvoeren



LPDISPATCH RetrieveObjectEx-retourwaarde

Retourwaarde

Beschrijving

LPDISPATCH

Pointer naar een OLE-dispatchobject. Het object is een CRemoteDataEx-object. Zie "Voorbeeld van Visual C++-code voor externe functionaliteit" op pagina 82 voor een voorbeeld van het koppelen van deze pointer aan een CRemoteDataEx-object.

LPDISPATCH CreateObject(LPCTSTR lpszFQName); Maakt een CRemoteData-object en retourneert een LPDISPATCH-pointer naar dit object. Zie Tabel 3-12 voor een definitie van de parameter. Tabel 3-12

LPDISPATCH CreateObject-parameter

Parameter

Beschrijving

LPCTSTR lpszFQName




LPDISPATCH CreateObject-retourwaarde

Retourwaarde

Beschrijving

LPDISPATCH

Pointer naar een OLE-dispatchobject. Het object is een CRemoteData-object. Zie "Voorbeeld van Visual C++-code voor externe functionaliteit" op pagina 82 voor een voorbeeld van het koppelen van deze pointer aan een CRemoteData-object.

LPDISPATCH CreateObjectEx(LPCTSTR lpszFQName); Maakt een CRemoteDataEx-object en retourneert een LPDISPATCH-pointer naar dit object. Zie Tabel 3-14 voor een definitie van de parameter. Tabel 3-14

LPDISPATCH CreateObjectEx-parameter

Parameter

Beschrijving

LPCTSTR lpszFQName



LPDISPATCH CreateObjectEx-retourwaarde

Retourwaarde

Beschrijving

LPDISPATCH

Pointer naar een OLE-dispatchobject. Het object is een CRemoteDataEx-object. Zie "Voorbeeld van Visual C++-code voor externe functionaliteit" op pagina 82 voor een voorbeeld van het koppelen van deze pointer aan een CRemoteDataEx-object.

71


BOOL DeleteObject(LPCTSTR lpszFQName, LPCTSTR lpszPassword); Verwijdert een extern-objectbestand. Zie Tabel 3-16 voor een definitie van de parameters. Tabel 3-16

BOOL DeleteObject-parameters

Parameter

Beschrijving

LPCTSTR lpszFQName

De naam van het te verwijderen volledig gekwalificeerde extern-objectbestand.




BOOL DeleteObject-retourwaarde

Retourwaarde

Beschrijving

BOOL


BOOL Launch(LPCTSTR lpszFQName); Start een extern-objectbestand waarmee het externe-terminalvenster van pcAnywhere wordt geopend. Zie Tabel 3-18 voor een definitie van de parameter. Tabel 3-18

BOOL Launch-parameter

Parameter

Beschrijving

LPCTSTR lpszFQName

Het te starten volledig gekwalificeerde externobjectbestand van object.


BOOL Launch-retourwaarde

Retourwaarde

Beschrijving

BOOL


Definities van Visual C++-objecten CRemoteData-object

CRemoteData-object Gebruik dit object om extern-objectgegevens aan te passen.

Get- en Set-methoden De volgende methoden worden gebruikt om eigenschappen van de CRemoteData-object op te halen en in te stellen. De computernaam is de naam van de pcAnywhere-hostcomputer die moet worden gebeld wanneer het externe object wordt gestart. BSTR GetComputerName(); void SetComputerName(LPCTSTR lpszNewValue);

Het telefoonnummer is het nummer dat moet worden gekozen om een modemverbinding met een pcAnywhere-hostcomputer tot stand te brengen. BSTR GetPhoneNumber(); void SetPhoneNumber(LPCTSTR lpszNewValue);

Geeft aan of gebruik moet worden gemaakt van TAPI-kieseigenschappen (locatiegegevens) (TRUE) of van de telefoonnummerstring exact zoals deze wordt weergegeven (FALSE). BOOL GetUseDialingProperties(); void SetUseDialingProperties(BOOL bNewValue);

Als kieseigenschappen moeten worden gebruikt, is dit het netnummer van het nummer dat wordt gebeld. BSTR GetAreaCode(); void SetAreaCode(LPCTSTR lpszNewValue);

Als kieseigenschappen moeten worden gebruikt, is dit het landnummer van het te bellen nummer. BSTR GetCountryCode(); void SetCountryCode(LPCTSTR lpszNewValue);

Het aantal pogingen om dit nummer opnieuw te bellen als de oproep is mislukt. short GetRedialCount(); void SetRedialCount(short nNewValue);

De wachttijd (in seconden) tussen pogingen om opnieuw te bellen. short GetRedialDelay(); void SetRedialDelay(short nNewValue);

73

74 Definities van Visual C++-objecten CRemoteData-object

De aanmeldnaam die naar de host moet worden verzonden wanneer een verbinding is gemaakt. Als deze niet is ingevuld, wordt de gebruiker tijdens het maken van de verbinding gevraagd een aanmeldnaam in te voeren. BSTR GetAutoLoginName(); void SetAutoLoginName(LPCTSTR lpszNewValue);

Het aanmeldwachtwoord dat naar de host moet worden verzonden wanneer een verbinding is gemaakt. Als dit niet is ingevuld, wordt de gebruiker tijdens het maken van de verbinding gevraagd een wachtwoord op te geven. BSTR GetAutoLoginPassword(); void SetAutoLoginPassword(LPCTSTR lpszNewValue);

Het wachtwoord voor dit object. BSTR GetPassword(); void SetPassword(LPCTSTR lpszNewValue);

Het object kan alleen worden gestart als het wachtwoord wordt gebruikt (TRUE). BOOL GetExecuteProtection(); void SetExecuteProtection(BOOL bNewValue);

Het object kan alleen worden weergegeven als het juiste wachtwoord wordt gegeven (TRUE). BOOL GetReadProtection(); void SetReadProtection(BOOL bNewValue);

Het object kan alleen worden geschreven als het juiste wachtwoord wordt gegeven (TRUE). BOOL GetWriteProtection(); void SetWriteProtection(BOOL bNewValue);

Regelt of sessies die dit object gebruiken, worden aangemeld. BOOL GetLogSession(); void SetLogSession(BOOL bNewValue);

Regelt of sessies die dit object gebruiken, vanaf het begin worden opgenomen. BOOL GetRecordSession(); void SetRecordSession(BOOL bNewValue);

De naam van het opnamebestand voor sessies die dit object gebruiken. BSTR GetRecordFile(); void SetRecordFile(LPCTSTR lpszNewValue);

Stelt de verbindingstypen in. BOOL GetRunOnConnect(); void SetRunOnConnect(BOOL bNewValue);


Hiervoor zijn de volgende opties beschikbaar: ■

COM1

■

COM2

■

COM3

■

COM4

■

Infrarood

■

ISDN via CAPI 2.0

■

LPT1

■

LPT2

■

LPT3

■

LPT4

■

NetBIOS

■

SPX

■

DEFAULT TAPI

■

TCP/IP

Ook kan de naam van een TAPI-apparaat als verbindingstype worden gebruikt. DEFAULT TAPI gebruikt het eerste TAPI-apparaat dat op het systeem wordt gevonden. Om een bepaald TAPI-apparaat te kunnen gebruiken moet u met FirstConnectionType() / NextConnectionType() beschikbare apparaten opzoeken.

Methoden details extern object Wanneer een extern object aan een verbindingstype wordt toegewezen, worden de apparaatdetails ingesteld op geldige standaardwaarden. De volgende verbindingstypen beschikken over geavanceerde configuratieopties die u in uw toepassing kunt instellen: ■

COM-apparaten

■

Netwerk (TCP/IP, SPX) gateway-apparaten Gateway-apparaten worden alleen in pcAnywhere 9.2x ondersteund.

■

NetBIOS-apparaten

■

ISDN via CAPI 2.0-apparaten (alleen Europese ISDN)

75


Details van COM-apparaat Stelt het niveau van de communicatiepariteit in BSTR GetComParity(); void SetComParity(LPCTSTR lpszNewValue);

De volgende waarden voor communicatiepariteit zijn beschikbaar: ■

Geen

■

Oneven

■

Even

■

Markeer

■

Spatie

Stelt het niveau van het gegevenstransport in. BSTR GetComFlowControl(); void SetComFlowControl(LPCTSTR lpszNewValue);

De volgende waarden voor gegevenstransport zijn beschikbaar: ■

■

XONXOFF

■

RTS/CTS

■

BOTH

Stelt de begininstelling voor de verbinding in. BSTR GetComStartedBy(); void SetComStartedBy(LPCTSTR lpszNewValue);

De volgende beginwaarden voor de verbinding zijn beschikbaar: ■

Altijd verbinding

■


■

Clear to send (CTS)

■


■

Ring indicator (RI)

■

2 's ontvangen

■

Modemrespons

Stelt de eindwaarden voor de verbinding in. BSTR GetComEndedBy(); void SetComEndedBy(LPCTSTR lpszNewValue);


De volgende eindwaarden voor de verbinding zijn beschikbaar: ■

Altijd verbinding

■


■

Clear to send (CTS)

■


■

Ring indicator (RI)

Stelt de verbindingssnelheid in. long GetComSpeed(); void SetComSpeed(long nNewValue);

De volgende snelheidswaarden voor de verbinding zijn beschikbaar: ■

110

■

300

■

600

■

1200

■

2400

■

4800

■

9600

■

19200

■

38400

■

57600

■

115200

Eigenschappen van netwerkapparaat (TCP/IP, SPX) voor gateways U kunt de volgende eigenschappen alleen met pcAnywhere 9.2x-verbindingen gebruiken: Verbinding maken via een pcAnywhere-gateway (TRUE). BOOL GetGatewayUse(); void SetGatewayUse(BOOL bNewValue);

Naam van de te gebruiken pcAnywhere-gateway. BSTR GetGatewayName(); void SetGatewayName(LPCTSTR lpszNewValue);

77


Klasse van de te gebruiken pcAnywhere-gateway. BSTR GetGatewayClass(); void SetGatewayClass(LPCTSTR lpszNewValue);

Pariteitswaarde van de te gebruiken pcAnywhere-gateway. BSTR GetGatewayParity(); void SetGatewayParity(LPCTSTR lpszNewValue);

De volgende pariteitswaarden zijn beschikbaar: ■

■

Oneven

■

Even

■

Markeer

■

Spatie

Details NetBios-apparaat Het LANA-nummer (LAN-adapter) dat u voor deze verbinding moet gebruiken. short GetLanaNumber(); void SetLanaNumber(short nNewValue);

Details ISDN via CAPI 2.0-apparaat Activeert kanaalverbinding (gebruikt twee ISDN-kanalen voor één verbinding) indien TRUE. BOOL GetCapiChannelBonding(); void SetCapiChannelBonding(BOOL bNewValue);

Stelt alle extra CAPI-extensies in die nodig zijn voor de communicatie. BSTR GetCapiExtensions(); void SetCapiExtensions(LPCTSTR lpszNewValue);

Methoden van externe objecten Hieronder staan de normale methoden van het externe object (deze methoden worden niet gebruikt voor het ophalen en instellen van eigenschappen): ■

short ConnectionTypes();

■

BSTR FirstConnectionType(); en BSTR NextConnectionType();

■

BOOL FindConnectionType(LPCTSTR lpszConnectionType);

■

short CountryCodes();


■

BSTR FirstCountryCode(); en BSTR NextCountryCode();

■

BOOL ReadObject(LPCTSTR lpszPassword);

■

BOOL WriteObject(LPCTSTR lpszPassword);

short ConnectionTypes(); Retourneert het aantal beschikbare verbindingstypen. Zie Tabel 3-20 voor de definitie van de retourwaarde. Tabel 3-20

short ConnectionTypes(); retourwaarde

Retourwaarde

Beschrijving

Short

Het aantal verbindingstypen dat werkelijk beschikbaar is op dit systeem.

BSTR FirstConnectionType(); en BSTR NextConnectionType(); FirstConnectionType() en NextConnectionType() worden gebruikt voor het doorlopen van de beschikbare verbindingstypen. De functies retourneren een BSTR, die de naam van een beschikbaar verbindingstype is. U kunt deze geretourneerde verbindingstypen gebruiken met de functie SetConnectionType(). Zie Tabel 3-21 voor de definitie van de retourwaarde. Tabel 3-21

BSTR FirstConnectionType(); en BSTR NextConnectionType(); retourwaarde

Retourwaarde

Beschrijving

BSTR

De naam van een ondersteund type verbindingsapparaat.

BOOL FindConnectionType(LPCTSTR lpszConnectionType); Retourneert TRUE als het opgegeven verbindingstype op de computer voorkomt. Zie Tabel 3-22 voor een definitie van de parameter. Tabel 3-22

BOOL FindConnectionType-parameter

Parameter

Beschrijving

LPCTSTR lpszConnectionType

De naam van een type verbindingsapparaat.

79



BOOL FindConnectionType-retourwaarde

Retourwaarde

Beschrijving

BOOL

TRUE als dit apparaattype beschikbaar is.

short CountryCodes(); Retourneert het aantal beschikbare landnummers. Zie Tabel 3-24 voor de definitie van de retourwaarde. Tabel 3-24

short CountryCodes(); retourwaarde

Retourwaarde

Beschrijving

Short

Het aantal beschikbare landnummers.

BSTR FirstCountryCode(); en BSTR NextCountryCode(); FirstCountryCode() en NextCountryCode() worden gebruikt voor het doorlopen van de beschikbare landnummers. De functies retourneren een BSTR, die de naam is van een beschikbaar landnummer. U kunt deze geretourneerde waarden gebruiken met de functie SetCountryCode(). Zie Tabel 3-25 voor de definitie van de retourwaarde. Tabel 3-25

BSTR FirstCountryCode(); en BSTR NextCountryCode(); retourwaarde

Retourwaarde

Beschrijving

BSTR

De eerste of volgende landnummerstring.

BOOL ReadObject(LPCTSTR lpszPassword); Leest de objectgegevens in het extern-objectbestand. Zie Tabel 3-26 voor een definitie van de parameter. Tabel 3-26

BOOL ReadObject-parameter

Parameter

Beschrijving


Het objectwachtwoord.

Definities van Visual C++-objecten CRemoteDataEx-object


BOOL ReadObject-retourwaarde

Retourwaarde

Beschrijving

BOOL


BOOL WriteObject(LPCTSTR lpszPassword); Schrijft de objectgegevens naar het externe-objectbestand. Zie Tabel 3-28 voor een definitie van de parameter. Tabel 3-28

BOOL WriteObject-parameter

Parameter

Beschrijving




BOOL WriteObject-retourwaarde

Retourwaarde

Beschrijving

BOOL

TRUE als het object met succes is weggeschreven.

CRemoteDataEx-object Het CRemoteDataEx-object bevat alle functies van het CRemoteData-object en de volgende Get- en Set-methoden: BSTR GetPrivateKey(); //Retourneert de PrivateKey-gegevens. void SetPrivateKey(LPCTSTR lpszNewValue); BSTR GetCertificationName(); //Retourneert de certificaatnaam. void SetCertificationName(LPCTSTR lpszNewValue); short GetEncryptionLevel(); //Retourneert de waarde van het coderingsniveau. void SetEncryptionLevel(short nNewValue); BOOL GetDenyLowerEncrypt(); //Retourneert de DenyLowerEncrypwaarde. void SetDenyLowerEncrypt(BOOL bNewValue); BSTR GetAutoDomain(); //Retourneert de AutoDomain-waarde. void SetAutoDomain(LPCTSTR lpszNewValue);

81

82 Definities van Visual C++-objecten CRemoteDataEx-object

Voorbeeld van Visual C++-code voor externe functionaliteit Met het volgende voorbeeld van een C++-functie wordt een extern object gemaakt, het verbindingstype ingesteld op TCP/IP, de computernaam ingesteld op het TCP/IP-adres dat in de functie is opgegeven en wordt vervolgens het externe object gestart: BOOL LaunchTCPRemote(LPCTSTR lpszAddress) { BOOL bReturn = FALSE; CRemoteDataManager remoteDM; CRemoteData remoteData; // Maak eerst de CremoteDataManager. remoteDM.CreateDispatch( _T( “WINAWSVR.RemoteDataManager”) ); //

Maak daarna CRemoteData en koppel deze eraan.

remoteData.AttachDispatch( remoteDM.CreateObject(“Test”, 0) ); // Stel nu de vereiste eigenschappen in. remoteData.SetConnectionType(“TCP/IP”); remoteData.SetComputerName(lpszAddress); // Sla de objectgegevens op. if (remoteData.WriteObject(0)) { // En start het. if (remoteData.Launch()) bReturn = TRUE; } // Geef het externe object vrij. remoteData.ReleaseDispatch(); remoteDM.ReleaseDispatch( _T( “WINAWSVR.RemoteDataManager”) ); return bReturn; }

Definities van Visual C++-objecten CHostDataManager-methoden

CHostDataManager-methoden De CHostDataManager-methoden leveren de parameters en retourwaarden voor het benaderen en besturen van CHostData-objecten.

BSTR CurrentDirectory(); Retourneert de volledige padnaam van de huidige map waarin hostobjecten van pcAnywhere zijn opgeslagen. Zie Tabel 3-30 voor de definitie van de retourwaarde. Tabel 3-30

BSTR CurrentDirectory(); retourwaarde

Retourwaarde

Beschrijving

BSTR


BOOL ChangeDirectory(LPCTSTR lpszNewDirectory); Wijzigt de huidige map waarin hostobjecten van pcAnywhere zijn opgeslagen. Zie Tabel 3-31 voor een definitie van de parameter. Tabel 3-31

BOOL ChangeDirectory-parameter

Parameter

Beschrijving

LPCTSTR lpszNewDirectory



BOOL ChangeDirectory-retourwaarde

Retourwaarde

Beschrijving

BOOL

TRUE indien gelukt

83

84 Definities van Visual C++-objecten CHostDataManager-methoden

BOOL FindFirst(LPCTSTR lpszPattern, BSTR FAR* pbstrFullQualName); Zoekt op basis van het opgegeven patroon van de bestandsnaam het eerste hostobjectbestand van pcAnywhere (*.BHF) in de huidige map op. Zie Tabel 3-33 voor een definitie van de parameters. Tabel 3-33

BOOL FindFirst-parameters

Parameter

Beschrijving

LPCTSTR lpszPattern



Retourbuffer voor de volledige padnaam van het extern-objectbestand dat overeenkomt met het opgegeven patroon.


BOOL FindFirst-retourwaarde

Retourwaarde

Beschrijving

BOOL

TRUE als een hostobjectbestand wordt gevonden dat overeenkomt met het opgegeven patroon. De volledige padnaam van het overeenkomende bestand wordt in pbstrFullQualName opgeslagen.

BOOL FindNext(BSTR FAR* pbstrFullQualName); Nadat FindFirst() is aangeroepen om de naam van een hostobjectbestand in de huidige map op te halen, kan FindNext() worden aangeroepen om het eventuele volgende bestand met een overeenkomend patroon te vinden. Zie Tabel 3-35 voor een definitie van de parameter. Tabel 3-35

BOOL FindNext-parameter

Parameter

Beschrijving


Retourbuffer voor de volledige padnaam van het hostobjectbestand dat overeenkomt met het patroon dat in de eerste oproep voor FindFirst() is opgegeven.



BOOL FindNext-retourwaarde

Retourwaarde

Beschrijving

BOOL

TRUE als een ander hostobjectbestand is gevonden dat overeenkomt met het patroon dat in de oproep voor FindFirst() is opgegeven. De volledige padnaam van het overeenkomende bestand wordt in pbstrFullQualName opgeslagen.

LPDISPATCH RetrieveObject(LPCTSTR lpszFQName, short wAccessMode, LPCTSTR lpszPassword); Haalt een CHostData-object op bestandsnaam op. Zie Tabel 3-37 voor een definitie van de parameters. Tabel 3-37

LPDISPATCH RetrieveObject-parameters

Parameter

Beschrijving

LPCTSTR lpszFQName


short wAccessMode



■

0 = Niet opgegeven

■


■


■

3 = Uitvoeren



LPDISPATCH RetrieveObject-retourwaarde

Retourwaarde

Beschrijving

LPDISPATCH

Pointer naar een OLE-dispatchobject. Het object is een CHostData-object. Zie "Voorbeeld van Visual C++-code voor hostfunctionaliteit" op pagina 102 voor een voorbeeld van het koppelen van deze pointer aan een CHostData-object.

85


LPDISPATCH RetrieveObjectEx(LPCTSTR lpszFQName, short wAccessMode, LPCTSTR lpszPassword); Haalt een CHostDataEx-object op bestandsnaam op. Zie Tabel 3-39 voor een definitie van de parameters. Tabel 3-39


Parameter

Beschrijving

LPCTSTR lpszFQName


short wAccessMode



■

0 = Niet opgegeven

■


■


■

3 = Uitvoeren



LPDISPATCH RetrieveObjectEx-retourwaarde

Retourwaarde

Beschrijving

LPDISPATCH

Pointer naar een OLE-dispatchobject. Het object is een CHostDataEx-object. Zie "Voorbeeld van Visual C++-code voor hostfunctionaliteit" op pagina 102 voor een voorbeeld van het koppelen van deze pointer aan een CHostDataEx-object.


LPDISPATCH CreateObject(LPCTSTR lpszName); Maakt een CHostData-object en retourneert een LPDISPATCH-pointer naar dit object. Zie Tabel 3-41 voor een definitie van de parameter. Tabel 3-41

LPDISPATCH CreateObject-parameter

Parameter

Beschrijving

LPCTSTR lpszFQName



LPDISPATCH CreateObject-retourwaarde

Retourwaarde

Beschrijving

LPDISPATCH

Pointer naar een OLE-dispatchobject. Het object is een CHostData-object. Zie "Voorbeeld van Visual C++-code voor hostfunctionaliteit" op pagina 102 voor een voorbeeld van het koppelen van deze pointer aan een CHostData-object.

LPDISPATCH CreateObjectEx(LPCTSTR lpszName); Maakt een CHostDataEx-object en retourneert een LPDISPATCH-pointer naar dit object. Zie Tabel 3-43 voor een definitie van de parameter. Tabel 3-43

LPDISPATCH CreateObjectEx-parameter

Parameter

Beschrijving

LPCTSTR lpszFQName


87



LPDISPATCH CreateObjectEx-retourwaarde

Retourwaarde

Beschrijving

LPDISPATCH

Pointer naar een OLE-dispatchobject. Het object is een CHostDataEx-object. Zie "Voorbeeld van Visual C++-code voor hostfunctionaliteit" op pagina 102 voor een voorbeeld van het koppelen van deze pointer aan een CHostDataEx-object.

BOOL DeleteObject(LPCTSTR lpszFQName, LPCTSTR lpszPassword); Verwijdert een hostobjectbestand. Zie Tabel 3-45 voor een definitie van de parameters. Tabel 3-45

BOOL DeleteObject-parameters

Parameter

Beschrijving

LPCTSTR lpszFQName

De naam van het volledig gekwalificeerde hostobjectbestand van het te verwijderen object.




BOOL DeleteObject-retourwaarde

Retourwaarde

Beschrijving

BOOL


BOOL Launch(LPCTSTR lpszFQName); Start een hostobjectbestand dat het hostterminalvenster van pcAnywhere opent. Zie Tabel 3-47 voor een definitie van de parameter. Tabel 3-47

BOOL Launch-parameter

Parameter

Beschrijving

LPCTSTR lpszFQName

De naam van het volledig gekwalificeerde hostobjectbestand van het te starten object.

Definities van Visual C++-objecten CHostData-object


BOOL Launch-retourwaarde

Retourwaarde

Beschrijving

BOOL


CHostData-object Gebruik dit object om hostobjectgegevens aan te passen.

Get- en Set-methoden Met de onderstaande methoden kunnen eigenschappen van het CHostDataobject worden opgehaald en ingesteld. Het telefoonnummer is het nummer dat moet worden gekozen om een modemverbinding met een pcAnywhere-remote tot stand te brengen. BSTR GetPhoneNumber(); void SetPhoneNumber(LPCTSTR lpszNewValue);

Geeft aan of gebruik moet worden gemaakt van TAPI-kieseigenschappen (locatiegegevens) (TRUE) of van de telefoonnummerstring exact zoals deze wordt weergegeven (FALSE). BOOL GetUseDialingProperties(); void SetUseDialingProperties(BOOL bNewValue);

Als kieseigenschappen moeten worden gebruikt, is dit het netnummer van het nummer dat wordt gebeld. BSTR GetAreaCode(); void SetAreaCode(LPCTSTR lpszNewValue);

Als kieseigenschappen moeten worden gebruikt, is dit het landnummer van het te bellen nummer. BSTR GetCountryCode(); void SetCountryCode(LPCTSTR lpszNewValue);

Het aantal pogingen om dit nummer opnieuw te bellen als de oproep is mislukt. short GetRedialCount(); void SetRedialCount(short nNewValue);

De wachttijd (in seconden) tussen pogingen om opnieuw te bellen. short GetRedialDelay(); void SetRedialDelay(short nNewValue);

89

90 Definities van Visual C++-objecten CHostData-object

Regelt of sessies die dit object gebruiken, worden aangemeld. BOOL GetLogSession(); void SetLogSession(BOOL bNewValue);

Regelt of sessies die dit object gebruiken, vanaf het begin worden opgenomen. BOOL GetRecordSession(); void SetRecordSession(BOOL bNewValue);

De naam van het opnamebestand voor sessies die dit object gebruiken. BSTR GetRecordFile(); void SetRecordFile(LPCTSTR lpszNewValue);

Methoden details hostobject Wanneer een hostobject aan een verbindingstype is toegewezen, worden de apparaatdetails ingesteld om standaardwaarden te valideren. De volgende verbindingstypen beschikken over geavanceerde configuratieopties die u in uw toepassing kunt instellen: ■

COM-apparaten

■

Netwerk (TCP/IP, SPX) gateway-apparaten Gateway-apparaten worden alleen in pcAnywhere 9.2x ondersteund.

■

NetBIOS-apparaten

■

NASI/NCSI-apparaten

■

ISDN via CAPI 2.0-apparaten (alleen Europese ISDN)

Details van COM-apparaat De volgende code plaatst het gevraagde verbindingstype in de lijst met toegewezen verbindingstypen van het hostobject en maakt dit het huidige verbindingstype bij het verwerken van volgende apparaatspecifieke methodeoproepen. BOOL AssignConnection(LPCTSTR lpszNewValue);

Als het aangevraagde verbindingstype al in de lijst met toegewezen verbindingen staat, verandert deze lijst niet. Alleen het huidige verbindingstype wordt gewijzigd in het aangevraagde type. Het is normaal om de AssignConnectionmethode meerdere malen op hetzelfde object aan te roepen bij het ophalen en instellen van verbindingsspecifieke waarden. AssignConnection retourneert TRUE als het opgegeven verbindingstype op de computer staat en met succes is toegewezen of al was toegewezen. FALSE wordt geretourneerd als het gevraagde verbindingstype niet op de computer staat of als het maximale aantal toegewezen verbindingen is bereikt.


Het hostobject van pcAnywhere ondersteunt maximaal twee toegewezen verbindingstypen. De AssignConnection-methode retourneert FALSE als iemand een poging doet de grens te overschrijden. Hiervoor zijn de volgende opties beschikbaar: ■

COM1

■

COM2

■

COM3

■

COM4

■

SPX

■

NetBIOS

■

TCP/IP

■

LPT1

■

LPT2

■

LPT3

■

LPT4

■

ISDN via CAPI 2.0

■

Infrarood

■

DEFAULT TAPI

Ook kan de naam van een TAPI-apparaat als verbindingstype worden gebruikt. DEFAULT TAPI gebruikt het eerste TAPI-apparaat dat op het systeem wordt gevonden. Om een bepaald TAPI-apparaat te kunnen gebruiken, moet u met FirstConnectionType() en NextConnectionType() beschikbare apparaten opzoeken. De volgende code maakt de toewijzing van een verbindingstype ongedaan. Nadat de toewijzing van een verbindingstype ongedaan is gemaakt, wordt de eventueel overgebleven toegewezen verbinding het huidige verbindingstype voor volgende apparaatspecifieke methodeoproepen. BOOL UnassignConnection(LPCTSTR lpszNewValue);

De volgende code stelt de niveaus van de pariteitsniveaus van de communicatie in: BSTR GetComParity(); void SetComParity(LPCTSTR lpszNewValue);

91


De volgende waarden voor communicatiepariteit zijn beschikbaar: ■

Geen

■

Oneven

■

Even

■

Markeer

■

Spatie

De volgende code stelt de niveaus van het gegevensstransport in: BSTR GetComFlowControl();void SetComFlowControl(LPCTSTR lpszNewValue);

De volgende waarden voor gegevenstransport zijn beschikbaar: ■

■

XONXOFF

■

RTS/CTS

■

BOTH

De volgende code stelt de beginwaarden van de verbinding in: BSTR GetComStartedBy(); void SetComStartedBy(LPCTSTR lpszNewValue);

De volgende beginwaarden voor de verbinding zijn beschikbaar: ■

Altijd verbinding

■


■

Clear to send (CTS)

■


■

Ring indicator (RI)

■

2 's ontvangen

■

Modemrespons

De volgende code stelt de eindwaarden van de verbinding in: BSTR GetComEndedBy(); void SetComEndedBy(LPCTSTR lpszNewValue);


De volgende eindwaarden voor de verbinding zijn beschikbaar: ■

Altijd verbinding

■


■

Clear to send (CTS)

■


■

Ring indicator (RI)

De volgende code stelt de snelheid van de verbinding in: long GetComSpeed(); void SetComSpeed(long nNewValue);

De volgende snelheidswaarden voor de verbinding zijn beschikbaar: ■

110

■

300

■

600

■

1200

■

2400

■

4800

■

9600

■

19200

■

38400

■

57600

■

115200

Eigenschappen van netwerkapparaat (TCP/IP, SPX) voor gateways U kunt de volgende eigenschappen alleen met pcAnywhere 9.2x-verbindingen gebruiken: Verbinding maken via een pcAnywhere-gateway (TRUE). BOOL GetGatewayUse(); void SetGatewayUse(BOOL bNewValue);

Naam van de te gebruiken pcAnywhere-gateway. BSTR GetGatewayName(); void SetGatewayName(LPCTSTR lpszNewValue);

93


Klasse van de te gebruiken pcAnywhere-gateway. BSTR GetGatewayClass(); void SetGatewayClass(LPCTSTR lpszNewValue);

Pariteitswaarden van de te gebruiken pcAnywhere-gateway. BSTR GetGatewayParity(); void SetGatewayParity(LPCTSTR lpszNewValue);

De volgende pariteitswaarden zijn beschikbaar: ■

■

Oneven

■

Even

■

Markeer

■

Spatie

Details NetBios-apparaat Het LANA-nummer (LAN-adapter) dat u voor deze verbinding moet gebruiken. short GetLanaNumber();void SetLanaNumber(short nNewValue);

Details NASI/NCSI-apparaat Stelt de gebruikersnaam voor de NASI-server in. BSTR GetNasiUserName(); void SetNasiUserName(LPCTSTR lpszNewValue);

Stelt het gebruikerswachtwoord voor de NASI-server in. BSTR GetNasiPassword(); void SetNasiPassword(LPCTSTR lpszNewValue);

Stelt de naam voor de NASI-sessie in. BSTR GetNasiSessionName(); void SetNasiSessionName(LPCTSTR lpszNewValue); BOOL GetNasiSessionNameAvailable(); void SetNasiSessionNameAvailable(BOOL bNewValue);

Geeft de te gebruiken NASI-server op. BOOL NasiServer(); BSTR GetNasiServerName(); void SetNasiServerName(LPCTSTR lpszNewValue);


Geeft de te gebruiken NASI-service op. BOOL NasiService(); BSTR GetNasiServiceName(); void SetNasiServiceName(LPCTSTR lpszNewValue);

Geeft de te gebruiken NASI-poort op. BOOL NasiPort(); BSTR GetNasiPortName(); void SetNasiPortName(LPCTSTR lpszNewValue); BOOL GetNasiSelectOnConnect(); void SetNasiSelectOnConnect(BOOL bNewValue);

Details ISDN via CAPI 2.0-apparaat Activeert kanaalverbinding (gebruikt twee ISDN-kanalen voor één verbinding) indien TRUE. BOOL GetCapiChannelBonding(); void SetCapiChannelBonding(BOOL bNewValue);

Stelt alle extra CAPI-extensies in die nodig zijn voor de communicatie. BSTR GetCapiExtensions(); void SetCapiExtensions(LPCTSTR lpszNewValue);

Hostobjectmethoden Hieronder staan de normale methoden van het object (deze methoden worden niet gebruikt voor het ophalen en instellen van eigenschappen): ■

short ConnectionTypes();

■

BSTR FirstConnectionType(); en BSTR NextConnectionType();

■

BOOL FindConnectionType(LPCTSTR lpszConnectionType);

■

short MaxAssignedConnections()

■

short AssignedConnections()

■

BSTR FirstAssignedConnection(); en BSTR NextAssignedConnection();

■

BOOL FindAssignedConnection (LPCTSTR lpszConnectionType);

■

short CountryCodes();

■

BSTR FirstCountryCode(); en BSTR NextCountryCode();

■

BOOL ReadObject(LPCTSTR lpszPassword);

■

BOOL WriteObject(LPCTSTR lpszPassword);

95


short ConnectionTypes(); Retourneert het aantal beschikbare verbindingstypen. Zie Tabel 3-49 voor de definitie van de retourwaarde. Tabel 3-49

short ConnectionTypes(); retourwaarde

Retourwaarde

Beschrijving

Short

Het aantal verbindingstypen dat werkelijk beschikbaar is op dit systeem.

BSTR FirstConnectionType(); en BSTR NextConnectionType(); FirstConnectionType() en NextConnectionType() worden gebruikt voor het doorlopen van de beschikbare verbindingstypen. De functies retourneren een BSTR, die de naam van een beschikbaar verbindingstype is. U kunt deze geretourneerde verbindingstypen gebruiken met de functie SetConnectionType(). Zie Tabel 3-50 voor de definitie van de retourwaarde. Tabel 3-50

BSTR FirstConnectionType(); en BSTR NextConnectionType(); retourwaarde

Retourwaarde

Beschrijving

BSTR


BOOL FindConnectionType(LPCTSTR lpszConnectionType); Retourneert TRUE als het opgegeven verbindingstype op de computer voorkomt. Zie Tabel 3-51 voor een definitie van de parameter. Tabel 3-51

BOOL FindConnectionType-parameter

Parameter

Beschrijving




BOOL FindConnectionType-retourwaarde

Retourwaarde

Beschrijving

BOOL

TRUE als dit apparaattype beschikbaar is.


short MaxAssignedConnections() Retourneert het maximale aantal verbindingstypen dat tegelijkertijd kan worden toegewezen (op dit ogenblik twee). Zie Tabel 3-53 voor de definitie van de retourwaarde. Tabel 3-53

short MaxAssignedConnections()-retourwaarde

Retourwaarde

Beschrijving

Short

Het maximale aantal toewijzingen van verbindingstypen.

short AssignedConnections() Retourneert het aantal toegewezen verbindingstypen. Zie Tabel 3-54 voor de definitie van de retourwaarde. Tabel 3-54

short AssignedConnections()-retourwaarde

Retourwaarde

Beschrijving

Short

Het aantal toegewezen verbindingstypen op dit systeem.

BSTR FirstAssignedConnection(); en BSTR NextAssignedConnection(); FirstAssignedConnection() en NextAssignedConnection() worden gebruikt om door de lijst van toegewezen verbindingen te lopen. Deze functies retourneren een BSTR, die de naam is van een toegewezen verbindingstype. U kunt deze geretourneerde verbindingstypen gebruiken met de functie AssignConnection(). Zie Tabel 3-55 voor de definitie van de retourwaarde. Tabel 3-55

BSTR FirstAssignedConnection(); en BSTR NextAssignedConnection(); retourwaarde

Retourwaarde

Beschrijving

BSTR


97


BOOL FindAssignedConnection (LPCTSTR lpszConnectionType); Retourneert TRUE als het opgegeven verbindingstype op dat moment op de computer is toegewezen. Zie Tabel 3-56 voor een definitie van de parameter. Tabel 3-56

BOOL FindAssignedConnection-parameter

Parameter

Beschrijving




BOOL FindAssignedConnection-retourwaarde

Retourwaarde

Beschrijving

BOOL

TRUE als dit apparaattype is toegewezen.

short CountryCodes(); Retourneert het aantal beschikbare landnummers. Zie Tabel 3-58 voor de definitie van de retourwaarde. Tabel 3-58

short CountryCodes(); retourwaarde

Retourwaarde

Beschrijving

Short

Het aantal beschikbare landnummers.

BSTR FirstCountryCode(); en BSTR NextCountryCode(); FirstCountryCode() en NextCountryCode() worden gebruikt voor het doorlopen van de lijst met beschikbare landnummers. De functies retourneren een BSTR, die de naam is van een beschikbaar landnummer. U kunt deze geretourneerde waarden gebruiken met de functie SetCountryCode(). Zie Tabel 3-59 voor de definitie van de retourwaarde. Tabel 3-59

BSTR FirstCountryCode(); en BSTR NextCountryCode(); retourwaarde

Retourwaarde

Beschrijving

BSTR

De eerste of volgende landnummerstring.


BOOL ReadObject(LPCTSTR lpszPassword); Leest de objectgegevens van het hostobjectbestand. Zie Tabel 3-60 voor een definitie van de parameter. Tabel 3-60

BOOL ReadObject-parameter

Parameter

Beschrijving




BOOL ReadObject-retourwaarde

Retourwaarde

Beschrijving

BOOL


BOOL WriteObject(LPCTSTR lpszPassword); Schrijft de objectgegevens naar het hostobjectbestand. Zie Tabel 3-62 voor een definitie van de parameter. Tabel 3-62

BOOL WriteObject-parameter

Parameter

Beschrijving




BOOL WriteObject-retourwaarde

Retourwaarde

Beschrijving

BOOL

TRUE als het object met succes is weggeschreven.

99

100 Definities van Visual C++-objecten CHostDataEx-object

CHostDataEx-object Het CHostDataEx-object bevat alle functies van het CHostData-object en de volgende Get- en Set-methoden: BOOL GetReadProtection(); void SetReadProtection(BOOL bNewValue); BOOL GetWriteProtection(); void SetWriteProtection(BOOL bNewValue); BSTR GetPassword(); //Retourneert “NIET GEÏMPLEMENTEERD”. void SetPassword(LPCTSTR lpszNewValue); BSTR GetCallersPath(); void SetCallersPath(LPCTSTR lpszNewValue); BOOL GetConfirmConnect(); void SetConfirmConnect(BOOL bNewValue); short GetConfirmTimeout(); void SetConfirmTimeout(short nNewValue); BOOL GetConfirmDeny(); void SetConfirmDeny(BOOL bNewValue); BOOL GetPwCaseSensitive(); void SetPwCaseSensitive(BOOL bNewValue); short GetPwAttempts(); void SetPwAttempts(short nNewValue); short GetPwTimeout(); void SetPwTimeout(short nNewValue); short GetActiveKbds(); void SetActiveKbds(short nNewValue); //Stelt ActiveKbds in short GetInactiveTimeout(); void SetInactiveTimeout(short nNewValue); short GetCryptReqLevel(); void SetCryptReqLevel(short nNewValue); BOOL GetCryptRefuseLower(); void SetCryptRefuseLower(BOOL bNewValue); short GetAuthenticationType(); void SetAuthenticationType(short nNewValue); BOOL GetLockSystemWhileWait(); void SetLockSystemWhileWait(BOOL bNewValue); BOOL GetMinimizeOnLaunch();

Definities van Visual C++-objecten CHostDataEx-object

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(); void SetConnLostSecurity(short nNewValue); short GetCallbkDelay(); void SetCallbkDelay(short nNewValue); BOOL GetEndSessHostOpts(); void SetEndSessHostOpts(BOOL bNewValue); BOOL GetEnableEndSessSecurity(); void SetEnableEndSessSecurity(BOOL bNewValue); short GetEndSessSecurity(); void SetEndSessSecurity(short nNewValue); BSTR GetCryptPrivateKey(); void SetCryptPrivateKey(LPCTSTR lpszNewValue); BSTR GetCryptCommonName(); void SetCryptCommonName(LPCTSTR lpszNewValue); BOOL GetBlankHost(); void SetBlankHost(BOOL bNewValue); BOOL GetAllowRemoteMouse(); void SetAllowRemoteMouse(BOOL bNewValue); short GetRebootOnDisconnect(); void SetRebootOnDisconnect(short nNewValue); BOOL GetPasswordAfterDisc(); void SetPasswordAfterDisc(BOOL bNewValue); BOOL GetLogFailures(); void SetLogFailures(BOOL bNewValue); BOOL GetAllowDriveSecurity(); void SetAllowDriveSecurity(BOOL bNewValue); BOOL GetExecuteProtection(); void SetExecuteProtection(BOOL bNewValue);

101

102 Definities van Visual C++-objecten CHostDataEx-object

Voorbeeld van Visual C++-code voor hostfunctionaliteit In het volgende voorbeeld van een Visual C++-functie wordt een hostobject gemaakt, het verbindingstype ingesteld op TCP/IP, de computernaam ingesteld op het TCP/IP-adres dat in de functie is opgegeven en wordt vervolgens het hostobject gestart: BOOL LaunchTCPHost(LPCTSTR lpszAddress) { BOOL bReturn = FALSE; CHostDataManager hostDM; CHostData hostData; // Maak eerst de ChostDataManager. hostDM.CreateDispatch( _T( "WINAWSVR.BeHostDataManager") ); //

Maak daarna CRemoteData en koppel deze eraan.

hostData.AttachDispatch(hostDM.CreateObject("Test", 0) ); // Stel nu de vereiste eigenschappen in. hostData.SetConnectionType("TCP/IP"); // Sla de objectgegevens op. if (hostData.WriteObject(0)) { // En start het. if (hostData.Launch()) bReturn = TRUE; } // Geef het hostobject vrij. hostData.ReleaseDispatch(); return (bReturn); }

Definities van Visual C++-objecten Awrem32-functies

Awrem32-functies De Awrem32-functies leveren de parameters en retourwaarden voor het afhandelen van verbindingen tussen een hostcomputer en een externe computer.

boolean awConnect(BSTR FileName); Maakt de verbinding met de hostcomputer. Zie Tabel 3-64 voor een definitie van de parameter. Tabel 3-64

Boolean awConnect-parameter

Parameter

Beschrijving

Name as string

De naam van het volledig gekwalificeerde chfbestand dat informatie over de hostcomputer bevat.


Boolean awConnect-retourwaarde

Retourwaarde

Beschrijving

Boolean

Voert de opdracht uit.

Boolean awDisconnect(); Verbreekt de verbinding met de hostcomputer. Zie Tabel 3-66 voor de definitie van de retourwaarde. Tabel 3-66

boolean awDisconnect(); retourwaarde

Retourwaarde

Beschrijving

Boolean

Nadat deze functie is aangeroepen, moet het aanroepende programma het object verwijderen (C++ - delete IAwrem32X*, VB – set ObjectName = Nothing;).

103

104 Definities van Visual C++-objecten Awrem32-functies

Boolean FileXferFromHost(BSTR HostFile, BSTR RemoteFile); Kopieert een bestand van de hostcomputer naar de externe computer. De parameters kunnen jokertekens bevatten. Zie Tabel 3-67 voor een definitie van de parameters. Tabel 3-67

Boolean FileXferFromHost-parameters

Parameter

Beschrijving

HostFile as string

Bevat de naam van het volledig gekwalificeerde pad en bestand die vanaf de hostcomputer moeten worden gekopieerd.


Bevat de naam van het volledig gekwalificeerde doelpad en bestand. De strings HostFile en RemoteFile hoeven niet gelijk aan elkaar te zijn.


boolean FileXferFromHost-retourwaarde

Retourwaarde

Beschrijving

Boolean


Boolean FileXferToHost(BSTR HostFile, BSTR RemoteFile); Kopieert een bestand van de externe computer naar de hostcomputer. De parameters kunnen jokertekens bevatten. Zie Tabel 3-69 voor een definitie van de parameters. Tabel 3-69

Boolean FileXferToHost-parameters

Parameter

Beschrijving

HostFile as string

Bevat de naam van het volledig gekwalificeerde doelpad en bestand.


Bevat de naam van het volledig gekwalificeerde pad en bestand die vanaf de externe computer moeten worden gekopieerd. De strings HostFile en RemoteFile hoeven niet gelijk aan elkaar te zijn.

Definities van Visual C++-objecten Awrem32-functies


Boolean FileXferToHost-retourwaarde

Retourwaarde

Beschrijving

Boolean


Boolean CreateFolderOnHost(BSTR FolderName); Maakt een nieuwe map op de hostcomputer. Op de externe computer wordt een tijdelijke map gemaakt, die vervolgens naar de host wordt gekopieerd. Zie Tabel 3-71 voor een definitie van de parameter. Tabel 3-71

Boolean CreateFolderOnHost-parameter

Parameter

Beschrijving

FolderName as string

Bevat het station en pad voor de map die op de hostcomputer wordt gemaakt.


Boolean CreateFolderOnHost-retourwaarde

Retourwaarde

Beschrijving

Boolean


Boolean ExecuteHostFile(BSTR FileName); Voert een bestaand bestand op de hostcomputer uit. Deze functie voert alleen batch- en opdrachtbestanden en uitvoerbare bestanden uit. Uitvoerbare bestanden die aan bestanden zijn gekoppeld, worden niet uitgevoerd. Als u bijvoorbeeld een doc-bestand uitvoert, wordt Microsoft Word niet gestart. Zie Tabel 3-73 voor een definitie van de parameter. Tabel 3-73

Boolean ExecuteHostFile-parameter

Parameter

Beschrijving

FileName as string

Bevat het volledig gekwalificeerde pad naar het bestand op de hostcomputer.

105

106 Definities van Visual C++-objecten Awrem32-functies


Boolean ExecuteHostFile-retourwaarde

Retourwaarde

Beschrijving

Boolean


BSTR GetError(); Retourneert de laatste fout als een string. Zie Tabel 3-75 voor de definitie van de retourwaarde. Tabel 3-75

BSTR GetError(); retourwaarde

Retourwaarde

Beschrijving

String

Retourneert de laatste fout die is opgetreden in Awrem32.

short ConnectionStatus(); Retourneert de huidige status van uw verbinding met de hostcomputer. Zie Tabel 3-76 voor de definitie van de retourwaarde. Tabel 3-76

short ConnectionStatus(); retourwaarde

Retourwaarde

Beschrijving

Short

De mogelijke waarden zijn: ■

-1 = Verbinding is verbroken

■

0 = Geen verbinding

■

1 = Sessie is verbonden

Index

A API-bibliotheken 12 apparaten. Zie verbindingstypen automatiseringscontrollers info over Visual Basic 10 info over Visual C++ 12 automatiseringsserver. Zie pcAnywhere Automation Server Awrem32 functies 61, 103 typebibliotheek 12

B bestanden, uitvoeren op de host 64, 105 bestandsverzending naar host 63, 104 vanaf host 62, 104

C C: Zie Visual C++ CAPI-verbindingen externe eigenschappen 31, 78 hosteigenschappen 51, 95 CHostData Visual Basic gebruiken 41 Visual C++ gebruiken 89 CHostDataEx Visual Basic gebruiken 52 Visual C++ gebruiken 100 CHostDataManager Visual Basic gebruiken 36 Visual C++ gebruiken 83 coderingsinstellingen op afstand 32, 33, 81 op host 52, 100 COM-apparaten details extern apparaat 28, 76 details hostapparaat 47, 90

CRemoteData Visual Basic gebruiken 22 Visual C++ gebruiken 73 CRemoteDataEx Visual Basic gebruiken 32 Visual C++ gebruiken 81 CRemoteDataManager Visual Basic gebruiken 17 Visual C++ gebruiken 67

E externe engine automatisch registreren 9 handmatig registreren 10 externe objecten apparaatdetails 75 bestanden 18-20, 36, 68-70 eigenschappen voor bellen 27 maken 70 mappen 17, 67 methoden 78 verwijderen 21, 72 wachtwoorden 80

G gateway-eigenschappen 32, 51, 77, 93 gegevenstransport 28, 48, 76, 92 GUID's 9

H hostobjecten apparaatdetails 90 eigenschappen voor bellen 46 maken 39, 87 mappen 36, 83 methoden 95 opzoeken 37-38, 84-86 starten 40, 88 verwijderen 40, 88 wachtwoorden 99

108 Index

I

O

identificaties. Zie GUID's. ISDN, CAPI-verbindingen externe eigenschappen 31, 78 hosteigenschappen 51, 95

OLE-automatisering. Zie pcAnywhere Automation Server

K klassendefinities importeren 13 weergeven 14

L landnummers op afstand 80 op host 98

M mappen, maken op host 63, 105 modemverbindingen op afstand COM-eigenschappen 28, 76 eigenschappen voor bellen 27 landnummers 80 TAPI-apparaten 75 op host COM-eigenschappen 47, 90 eigenschappen voor bellen 46 landnummers 98 TAPI-apparaten 91

N NASI-apparaten 94 NCSI-apparaten 94 NetBIOS-verbindingen externe eigenschappen 31, 78 hosteigenschappen 50, 94 netwerkverbindingen op afstand gateway-eigenschappen 32, 77 NetBIOS-eigenschappen 31, 78 op host gateway-eigenschappen 51, 93 NetBIOS-eigenschappen 50, 94

P pariteit 28, 47, 76, 91 pcAnywhere Automation Server GUID's registreren 9 info 8 toegang met Visual C++ 12 toegang tot Visual Basic 10 typebibliotheken 12 voorbeelden 9

R retourneren, fouten 64, 106 retourneren, status 64, 106

T TAPI-apparaten op afstand 75 op host 91 typebibliotheken 12

V verbindingen beëindigen 62, 103 fouten retourneren 106 starten 40, 61, 72, 103 status retourneren 64, 106 verbindingstypen externe eigenschappen 25, 75, 79 hosteigenschappen 43, 90, 95 toewijzen 45 toewijzing ongedaan maken 46 Visual Basic Awrem32-functies 61 CHostDataEx-object 52 CHostDataManager-object 36 CHostData-object 41 CRemoteDataEx-object 32 CRemoteDataManager-object 17 CRemoteData-object 22 toegang tot pcAnywhere Automation Server 10 voorbeelden met codes 34, 60

Index

Visual C++ Awrem32-functies 103 CHostDataEx-object 100 CHostDataManager-object 83 CHostData-object 89 CRemoteDataEx-object 81 CRemoteDataManager-object 67 CRemoteData-object 73 klassen importeren 13 met Winawsvr.h 14 toegang tot pcAnywhere Automation Server 12 voorbeelden met codes 82, 102 voorbeelden met codes Visual Basic 34, 60 Visual C++ 82, 102

W wachtwoorden op externe objecten 80 op hostobjecten 99 Winawsvr koptekstbestand 14 objecten CHostData 41, 89 CHostDataEx 52, 100 CHostDataManager 36, 83 CRemoteData 22, 73 CRemoteDataEx 32, 81 CRemoteDataManager 17, 67 programmabestand 10 typebibliotheek 12

109

Ondersteuning

Service en ondersteuning Het doel van Symantec is het wereldwijd leveren van uitstekende service. Bij ons krijgt u professionele ondersteuning bij het gebruik van onze software en services, waar u zich ook maar bevindt. De oplossingen voor technische ondersteuning en klantenservice variëren per land. Als u vragen hebt over de services die hieronder worden beschreven, raadpleegt u de sectie "Wereldwijde service en ondersteuning – contactinformatie" aan het eind van dit hoofdstuk.

Registratie en licenties Als u voor het product dat u wilt implementeren, een registratie- en/of licentienummer nodig hebt, kunt u uw product het snelst registreren door naar onze licentie- en registratiesite te gaan op www.symantec.com/certificate. U kunt ook naar http://www.symantec.com/techsupp/ent/enterprise.html gaan, daar het product selecteren dat u wilt registreren en op de homepage van het product de link Licenties en registratie selecteren. Als u een ondersteuningsabonnement hebt aangeschaft, hebt u recht op technische ondersteuning van Symantec via de telefoon en het internet. Wanneer u voor de eerste keer contact opneemt met Symantec-ondersteuning, verzoeken wij u het licentienummer van uw Licentiecertificaat bij de hand te hebben, of de contact-id die is gegenereerd bij de ondersteuningsregistratie, zodat wij uw recht op ondersteuning kunnen verifiëren. Als u geen ondersteuningsabonnement hebt aangeschaft, kunt u voor meer informatie over de aanschaf van technische ondersteuning bij Symantec contact opnemen met uw reseller of de klantenservice van Symantec.

112 Service en ondersteuning Registratie en licenties

Beveiligingsupdates De laatste informatie over virusdreigingen en beveiligingsrisico’s kunt u vinden op de website Symantec Security Response (voorheen genaamd Antivirus Research Center): http://securityresponse.symantec.com Deze site geeft uitgebreide informatie over beveiligingsrisico’s en virusdreigingen, en bevat tevens de laatste virusdefinities U kunt ook met de functie LiveUpdate in uw product virusdefinities downloaden.

Uw abonnement op virusdefinities verlengen Bij de aanschaf van een onderhoudscontract bij uw product kunt u gedurende de looptijd van dit contract gratis virusdefinities downloaden vanaf het internet. Als uw onderhoudscontract is verlopen, kunt u bij uw reseller of de klantenservice van Symantec meer informatie krijgen over het verlengen van dit contract.

Symantec-websites: Homepage van Symantec (per taal): Engels: Frans: Duits: Italiaans: Nederlands:

http://www.symantec.com http://www.symantec.fr http://www.symantec.de http://www.symantec.it http:// www.symantec.nl

Symantec Security Response: http://securityresponse.symantec.com

Service- en ondersteuningspagina van Symantec Enterprise: http://www.symantec.com/techsupp/ent/enterprise.html

Nieuwsbulletins met informatie over specifieke producten: VS, Azië Pacific/Engels: http://www.symantec.com/techsupp/bulletin/index.html Europa, Midden-Oosten en Afrika/Engels: http://www.symantec.com/region/reg_eu/techsupp/bulletin/index.html

Service en ondersteuning Technische ondersteuning

Frans: http://www.symantec.com/region/fr/techsupp/bulletin/index.html Duits: http://www.symantec.com/region/de/techsupp/bulletin/index.html Nederlands: http://www.symantec.com/region/nl/techsupp/bulletin/index.html Italiaans: http://www.symantec.com/region/it/techsupp/bulletin/index.html

Technische ondersteuning Als onderdeel van Symantec Security Response heeft Symantec wereldwijd ondersteuningscentra die u bij technische vragen kunnen helpen. Hun voornaamste rol is het beantwoorden van vragen over productkenmerken en -functies, installatie en configuratie, en ook over de inhoud van onze Knowledgebase op internet. Om uw vragen snel te kunnen beantwoorden, werken deze centra samen met andere groepen binnen Symantec. Zo wordt bijvoorbeeld samengewerkt met Product Engineering en de Security Research Centers voor het leveren van waarschuwingsservices en updates op virusdefinities bij virusuitbraken en nieuwe beveiligingsrisico's. Wij bieden onder meer: ■

Verschillende ondersteuningsopties waardoor wij aan bedrijven van elke grootte de gewenste hoeveelheid service kunnen bieden

■

Opties voor telefonische ondersteuning en ondersteuning via het internet met snelle responstijden en de allerlaatste informatie

■

Productupdates waardoor u altijd beschikt over de laatste versie van de software

■

Updates op virusdefinities en beveiliging waardoor u verzekerd bent van het hoogst mogelijke beveiligingsniveau

■

Wereldwijde ondersteuning van de experts van Symantec Security Response, 24 uur per dag en 7 dagen per week, in verschillende talen

■

Geavanceerde mogelijkheden zoals de Symantec Alerting Service en een Technical Account Manager voor proactieve ondersteuning van beveiliging met snelle responstijden

Raadpleeg onze website voor de laatste informatie over onze ondersteuningsprogramma's.

113

114 Service en ondersteuning Klantenservice

Contact opnemen met Ondersteuning Klanten met een geldige ondersteuningsovereenkomst kunnen telefonisch of via het internet contact opnemen met het team voor Technische ondersteuning via de onderstaande website of via de regionale ondersteuningssites die later in dit document worden genoemd. www.symantec.com/techsupp/ent/enterprise.html Zorg dat u de volgende informatie bij de hand hebt wanneer u contact opneemt met Ondersteuning. ■

Versienummer van het product

■

Hardwaregegevens

■

Beschikbaar geheugen, schijfruimte, NIC-gegevens

■

Besturingssysteem

■

Versie- en patchniveau

■

Netwerkstructuur

■

Informatie over router, gateway en IP-adres

■

Beschrijving van het probleem

■

Foutberichten/logbestanden

■

Actie ondernomen om het probleem op te lossen, voordat u met Symantec contact opnam

■

Recente wijzigingen aan de softwareconfiguratie en/of het netwerk

Klantenservice De afdeling Klantenservice van Symantec kan u helpen bij vragen van niettechnische aard, zoals: ■

Algemene informatie over een product (bijvoorbeeld functies, taalversies, resellers in uw regio, enzovoort)

■

Oplossen van basisproblemen, zoals hoe u het versienummer van uw product kunt achterhalen

■

De laatste informatie over updates en upgrades voor een product

■

Hoe u uw product kunt updaten/upgraden

■

Hoe u uw product en/of licenties kunt registreren

Service en ondersteuning Wereldwijde service en ondersteuning – contactinformatie

■

Informatie over de Licentieprogramma’s van Symantec

■

Informatie over upgrade insurance en onderhoudscontracten

■

Vervanging van cd's en handleidingen

■

Het bijwerken van uw productregistratie met een adres- of naamswijziging

■

Advies over de opties voor technische ondersteuning van Symantec

Uitgebreide informatie over onze klantenservice kunt u krijgen op de Symantecwebsite voor service en ondersteuning of door contact op te nemen met het Symantec Customer Service Centre. Het telefoonnummer voor de klantenservice in uw regio kunt u vinden in de sectie "Wereldwijde service en ondersteuning – contactinformatie" aan het eind van dit hoofdstuk.

Wereldwijde service en ondersteuning – contactinformatie Voor Europa, het Midden-Oosten en Afrika Websites voor service en ondersteuning van Symantec Engels: Frans: Duits: Italiaans: Nederlands: Symantec FTP: (voor het downloaden van technische notities en de laatste softwarepatches)

www.symantec.com/eusupport/ www.symantec.fr/frsupport www.symantec.de/desupport/ www.symantec.it/itsupport/ www.symantec.nl/nlsupport/ ftp.symantec.com

Ga naar de website voor service en ondersteuning van Symantec voor technische en niet-technische informatie over uw product.

Symantec Security Response: http://securityresponse.symantec.com

115

116 Service en ondersteuning Wereldwijde service en ondersteuning – contactinformatie

Nieuwsbulletins met informatie over specifieke producten: Engels (VS): http://www.symantec.com/techsupp/bulletin/index.html Europa, Midden-Oosten & Afrika/Engels: http://www.symantec.com/region/reg_eu/techsupp/bulletin/index.html Frans: http://www.symantec.com/region/fr/techsupp/bulletin/index.html Duits: http://www.symantec.com/region/de/techsupp/bulletin/index.html Nederlands: http://www.symantec.com/region/nl/techsupp/bulletin/index.html Italiaans: http://www.symantec.com/region/it/techsupp/bulletin/index.html

Symantec-klantenservice Voor telefonische informatie en advies bij kwesties van niet-technische aard in de volgende talen: Engels, Duits, Frans en Italiaans Oostenrijk + (43) 1 50 137 5030 België + (32) 2 2750173 Denemarken + (45) 35 44 57 04 Finland + (358) 9 22 906003 Frankrijk + (33) 1 70 20 00 00 Duitsland + (49) 69 6641 0315 Ierland + (353) 1 811 8093 Italië + (39) 02 48270040 Luxemburg + (352) 29 84 79 50 30 Nederland + (31) 20 5040698 Noorwegen + (47) 23 05 33 05 Zuid-Afrika + (27) 11 797 6639 Spanje + (34) 91 7456467 Zweden + (46) 8 579 29007 Zwitserland + (41) 2 23110001 GB + (44) 20 7744 0367 Overige landen + (353) 1 811 8093 (alleen in het Engels)


Correspondentieadres Symantec Customer Service Symantec Ltd. Customer Service Centre Europe, Middle East and Africa (EMEA) PO Box 5689 Dublin 15 Ireland

Voor Latijns-Amerika Symantec biedt wereldwijd technische ondersteuning en klantenondersteuning. De services variëren per land en worden mogelijk geleverd door Internationale Partners die Symantec vertegenwoordigen in gebieden zonder Symantecvestiging. Neem voor algemene informatie contact op met de Symantecvestiging voor service en ondersteuning in uw regio. Argentinië Pte. Roque Saenz Peña 832 - Piso 6 C1035AAQ, Ciudad de Buenos Aires Argentina Telefoon Website

+54 (11) 5811-3225 http://www.service.symantec.com/mx

Gold Support

0800-333-0306

Venezuela Avenida Francisco de Miranda. Centro Lido Torre D. Piso 4, Oficina 40 Urbanización el Rosal 1050, Caracas D.F. Venezuela Telefoon Website


Gold Support

0800-1-00-2543

Colombia Carrera 18# 86A-14 Oficina 407, Bogota D.C. Colombia Telefoon Website


Gold Support

980-915-5241

117


Brasil Symantec Brasil Market Place Tower Av. Dr. Chucri Zaidan, 920 12° andar São Paulo - SP CEP: 04583-904 Brasil, SA Telefoon Fax Website

+55 (11) 5189-6300 +55 (11) 5189-6210 http://www.service.symantec.com/br

Gold Support

000814-550-4172

Chile Alfredo Barros Errazuriz 1954 Oficina 1403 Providencia, Santiago de Chile Chile Telefoon Website


Gold Support

0800-333-0306

Mexico Boulevard Adolfo Ruiz Cortines 3642 Piso 8, Colonia Jardines del Pedregal, 01900, Mexico D.F. Mexico Telefoon Website


Gold Support

001880-232-4615


De rest van Latijns-Amerika 9155 South Dadeland Blvd. Suite 1100, Miami, FL 33156 U.S.A Website

http://www.service.symantec.com/mx

Gold Support

Costa Rica Panama Puerto Rico

800-242-9445 800-234-4856 800-232-4615

Voor Azië Pacific Symantec biedt wereldwijd technische ondersteuning en klantenondersteuning. De services variëren per land en worden mogelijk geleverd door Internationale Partners die Symantec vertegenwoordigen in gebieden zonder Symantecvestiging. Neem voor algemene informatie contact op met de Symantecvestiging voor service en ondersteuning in uw regio.

Symantec-vestigingen voor service en ondersteuning AUSTRALIË Symantec Australia Level 2, 1 Julius Avenue North Ryde, NSW 2113 Australia Telefoon Fax Website

+61 2 8879 1000 +61 2 8879 1001 http://service.symantec.com

Gold Support Onderhoudscontracten

1800 805 834 1800 808 089

[email protected] [email protected]

119


CHINA Symantec China Unit 1-4, Level 11, Tower E3, The Towers, Oriental Plaza No.1 East Chang An Ave., Dong Cheng District Beijing 100738 China P.R.C. Telefoon Technische ondersteuning Fax Website

+86 10 6264 8866 +86 10 6264 8866 +86 10 6257 4838 http://www.symantec.com.cn

HONG KONG Symantec Hong Kong Central Plaza Suite #3006 30th Floor, 18 Harbour Road Wanchai Hong Kong Telefoon Technische ondersteuning Fax Website

+852 2528 6206 +852 2528 6206 +852 2526 2646 http://www.symantec.com.hk

INDIA Symantec India Suite #801 Senteck Centrako MMTC Building Bandra Kurla Complex Bandra (East) Mumbai 400051, India Telefoon Fax Website Technische ondersteuning:

+91 22 652 0658 +91 22 652 0671 http://www.symantec.com/india +91 22 657 0669


KOREA Symantec Korea 15,16th Floor Dukmyung B/D 170-9 Samsung-Dong KangNam-Gu Seoul 135-741 South Korea Telefoon Fax Technische ondersteuning Website

+822 3420 8600 +822 3452 1610 +822 3420 8650 http://www.symantec.co.kr

MALEISIË Symantec Corporation (Malaysia) Sdn Bhd 31-3A Jalan SS23/15 Taman S.E.A. 47400 Petaling Jaya Selangor Darul Ehsan Malaysia Telefoon Fax E-mail van bedrijven Gratis nummer voor bedrijven

+603 7805 4910 +603 7804 9280 [email protected] +1800 805 104

Website

http://www.symantec.com.my

NIEUW-ZEELAND Symantec New Zealand Level 5, University of Otago Building 385 Queen Street Auckland Central 1001 New Zealand Telefoon Fax Website voor ondersteuning

+64 9 375 4100 +64 9 375 4101

Gold Support Support Contracts Admin

0800 174 045 0800 445 450

http://service.symantec.co.nz [email protected] [email protected]

121


SINGAPORE Symantec Singapore 3 Phillip Street #17-00 & #19-00 Commerce Point Singapore 048693 Telefoon Fax Technische ondersteuning Website

+65 6239 2000 +65 6239 2001 +65 6239 2099 http://www.symantec.com.sg

TAIWAN Symantec Taiwan 2F-7, No.188 Sec.5 Nanjing E. Rd., 105 Taipei Taiwan Telefoon Ondersteuning voor bedrijven

+886 2 8761 5800 +886 2 8761 5800

Fax Website

+886 2 2742 2838 http://www.symantec.com.tw

Er is alles aan gedaan om de nauwkeurigheid van dit document te waarborgen. De informatie in dit document kan echter zonder voorafgaande kennisgeving worden gewijzigd. Symantec Corporation behoudt zich het recht voor zonder voorafgaande kennisgeving informatie te wijzigen.

Symantec pcanywhere Handleiding OLEautomatisering

Recommend Documents