SYMANTEC pcAnywhere v12.5 User Manual [fr]

Guide d'automatisation OLE

Guide d'automatisation OLE

Mentions légales

Copyright © 2008 Symantec Corporation. Tous droits réservés.

Symantec et le logo Symantec sont des marques commerciales ou déposées de Symantec
Corporation oude sesfiliales, auxEtats-Unis etdans d'autrespays., Lesautres nomspeuvent
être des marques de leurs détenteurs respectifs.

Ce produit Symantec peut contenir un logiciel tiers pour lequel Symantec est requis pour
l'attribution à tiers ("Programmes tiers"). Certains programmes tiers sont disponibles sous
licences desource ouverteou de logiciellibre. lecontrat delicence accompagnant le Logiciel
ne modifie aucun droit ou engagement que vous pouvez avoir sous des licences de source
ouverte ou de logiciel libre. Veuillez consulter l'annexe des mentions légales de cette
documentation ou le fichier lisez-moi TPIP accompagnant ce produit Symantec pour plus
d'informations sur les programmes tiers.

Le produit décrit dans ce document est distribué aux termes d'une licence limitant son
utilisation, sa copie, sa distributionet sa décompilation/ingénierie inverse. Cedocument ne
peut, en tout ou partie, être reproduit sous aucune forme et par aucun moyen sans
l'autorisation préalable écrite de Symantec Corporation et de ses détenteurs de licence
éventuels.

LA DOCUMENTATIONEST FOURNIE"EN L'ETAT",ET TOUTEGARANTIE OUCONDITION
D'AUCUNE SORTE, EXPRESSE OU IMPLICITE, Y COMPRIS, SANS QUE CELA SOIT
LIMITATIF, LES GARANTIES OU CONDITIONS IMPLICITES DE QUALITE MARCHANDE,
D'ADEQUATION A UNUSAGE PARTICULIER OU DE RESPECTDES DROITS DE PROPRIETE
INTELLECTUELLE EST TENUE POUR JURIDIQUEMENT NON VALIDE. SYMANTEC
CORPORATION NE POURRA PAS ETRE TENUE RESPONSABLE DE DOMMAGES DIRECTS
OU INDIRECTS EN RELATION AVEC LE CONTENU OU L'UTILISATION DE LA PRESENTE
DOCUMENTATION. LES INFORMATIONS PRESENTES DANS CETTE DOCUMENTATION
SONT SUJETTES A MODIFICATION SANS PREAVIS.

Le logiciel et la documentation sous licence sont considérés "logiciel informatique
commercial" et "documentation de logiciel informatique commercial" t sujets aux droits
restreints selon les définitions des sections FAR 12.212 et DFARS 227.7202 autant
qu'applicables, ainsi que toute régulation issue de celles-ci. Toute utilisation, modification,
reproduction de version, performance, affichage ou divulgation du logiciel et de la
documentation sous licence, par le gouvernement des Etats-Unis, ne peut s'effectuer que
selon les termes de cet accord.

Symantec Corporation
20330 Stevens Creek Blvd.
Cupertino, CA 95014

http://www.symantec.fr

Fabriqué en Irlande.

10 9 8 7 6 5 4 3 2 1

Support technique

Le support technique de Symantec gère lescentres de support au niveau mondial.
Le supporttechnique a pour rôle essentiel de répondre à des demandes spécifiques
sur lescaractéristiques et les fonctions des produits. Ilest égalementresponsable
de la création des articlesde notre base de donnéesen ligne. Le groupe de support
technique collaboreavec lesautres entitésde Symantec pour répondre rapidement
à vos questions. Il travaille par exemple avec le département Ingénierie et
Symantec Security Response pour fournir des services d'alerte et desmises à jour
des définitions de virus.

Parmi les offres de maintenance de Symantec, il faut citer :

■ Une gammed'options desupport pourvous permettre de sélectionner le niveau

de service adapté à votre entreprise.

■ Un support par téléphone et sur le Web apportant des réponses rapides et des

informations de dernière minute.

■ Une assurance Mise à niveau fournissant une protection de la mise à niveau

automatique de logiciels.

■ Un support global de 24 heures sur 24 et 7 jours sur 7.

■ Des prestations évoluées telles que la gestion de compte de service.

Pour plus d'informations sur les programmes de maintenance proposés par
Symantec, visitez notre site Web à l'adresse suivante :

www.symantec.com/techsupp/

Entrer en contact avec le support technique

Les clients avec un contrat de maintenance en cours peuvent accéder à des
informations de support technique à l'URL suivante :

www.symantec.com/techsupp/

Avant d'entreren contact avec le support technique, assurez-vousd'avoir satisfait
la configuration requise indiquée dans votre documentation produit. En outre,
vous devriez être à l'ordinateur sur lequel le problème s'est produit, au cas où il
serait nécessaire de recréer le problème.

Quand vous entrez en contact avec le support technique, ayez s'il vous plaît les
informations suivantes disponibles :

■ Niveau de version du produit

■ Informations concernant le matériel

■ Mémoire disponible, espace disque, informations NIC

■ Système d'exploitation

■ Version et niveau de correctif

■ Topologie réseau

■ Routeur, passerelle, et informations d'adresse IP

■ Description du problème :

■ Messages d'erreur et fichiers journaux

■ Dépannage effectué avant d'entrer en contact avec Symantec

■ Changements deconfiguration récentsdu logicielet changementsde réseau

Licence et enregistrement

Si votreproduit Symantec requiert un enregistrement ou une clé delicence, visitez
la page Web de notre support technique à l'adresse suivante :

www.symantec.com/techsupp/

Service clientèle

Les informations de Service clientèle sont disponibles à l'URL suivante :

www.symantec.com/techsupp/

Le Service clientèle peut vous aider à résoudre des problèmesdes types suivants :

■ licence et numéros de série des produits ;

■ mise à jour des enregistrements de produit en cas de changement de nom ou

d'adresse ;

■ informations généralessur les produits (caractéristiques, langues disponibles,

distributeurs) ;

■ dernières informations sur les mises à jour et mises à niveau des produits ;

■ informations surles assurancesde mise à jour et les contrats de maintenance ;

■ informations au sujet de l'achat de programmes Symantec ;

■ conseil sur les options de support technique de Symantec ;

■ questions avant-vente non techniques ;

■ questions concernant les CD-ROM ou les manuels.

Ressources des accords de maintenance

Pour touteinformation sur les accords de maintenance, veuillez contacter l'équipe
administrative responsable de votre région :

[e-mail]-Pacifique et Japon

[e-mail], Moyen-Orient et Afrique

[e-mail]érique du Nord et Amérique latine

Services supplémentaires destinés aux entreprises

Symantec propose un ensemble complet de services qui vous permettront de
rentabiliser aumaximum vosproduits Symantec,de développervos compétences
et d'avoir une meilleure vue d'ensemble pour gérer plus efficacement les risques
auxquels votre entreprise doit faire face.

Les services destinés aux entreprises sont les suivants :

Symantec EarlyWarning Solutions

Services de supervision de la
sécurité

Services de conseil

Services de formation

Pour accéder à des informations supplémentaires concernant les services
d'entreprise, visitez notre site Web à l'adresse :

www.symantec.com

Sélectionnez le pays et la langue de votre choix dans l'index du site.

Ces solutions permettent que vous soyez prévenu précocement en cas de
cyber-attaque et vous appuyer sur une analyse exhaustive des menaces et des
contre-mesures pour prévenir les attaques avant qu'elles ne frappent.

Ces services évitent l'obligation de gérer et superviser les périphériques et les
événements de sécurité, garantissant ainsi une réponse rapide aux menaces
réelles.

Symantec Consulting Services garantissent une expertise technique sur site
apportée directement par Symantec ou ses partenaires agréés. Symantec
Consulting Servicespropose unesérie d'optionspréconçues etpersonnalisables
qui incluent des fonctions d'évaluation, de conception, de mise en oeuvre, de
surveillance et de gestion. Chacune porte sur l'établissement et la mise à jour
de l'intégrité et de la disponibilité de vos ressources informatiques.

Les services de formations fournissent une gamme complète de programmes
de formation technique, de formation à la sécurité, de certification de sécurité
et de communication de sensibilisation.

Table des matières

Support technique .. .... .... .... .... .... .... .... .... .... . ... . ... . ... . ... . ... . ... . ... . ... . .... .... .... .... .... ... 4

Chapitre 1 Utilisation de l'automatisation OLE avec Symantec

pcAnywhere . .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... . 9

A propos de l'automatisation OLE .... .... .... .... .... .... .... .... .... .... .... .... .... . 9

A propos du serveur d'automatisation pcAnywhere ... .... .... .... .... .... .... . 10

Ce que vous pouvez faire avec le serveur d'automatisation

pcAnywhere .... .... .... . ... . ... . ... . ... . ... . ... . ... . ... . .... .... .... .... .... .... .... . 10

Avant de commencer ... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... . 11

Inscription automatique du moteur distant ... .... .... .... .... .... .... .... .. 11

Inscription manuelle du moteur distant .... .... .... .... .... .... .... .... .... . 12

Accès au serveur d'automatisation pcAnywhere ... .... .... .... .... .... .... 12

Accès au serveur d'automatisation pcAnywhere avec Visual

Basic .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .. 12

Accès au serveur d'automatisation pcAnywhere avec Visual

C++ . .... .... .... .... .... .... .... . ... . ... . ... . ... . ... . ... . ... . ... . .... .... .... .... . 14

Démarrage des objets OLE hôte et distant ... .... .... .... .... .... .... .... .... 16

Pour plus d'informations . ... . ... . .... .... .... .... .... .... .... .... .... .... .... .... .... .. 16

Chapitre 2 Définitions d'objets Visual Basic .... .... .... .... .... .... .... .... .... .. 17

A propos des objets Visual Basic .... .... .... .... .... .... .... .... .... .... .... .... .... .. 17

Méthodes CRemoteDataManager .... .... .... .... .... .... .... .... .... .... .... .... .... 18

Propriétés CRemoteData . .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .. 21

Propriétés du type de connexion .... .... .... .... .... .... .... .... .... .... .... ... 23

Propriétés de numérotation . .... .... .... .... .... .... .... .... .... .... .... .... .... 25

Propriétés de périphérique COM .... .... .... .... .... .... .... .... .... .... .... ... 26

Propriétés de périphérique NetBIOS . .... .... .... .... .... .... .... .... .... .... . 29

Propriétés de périphérique RNIS via CAPI 2.0 ... .... .... .... .... .... .... ... 30

objet CRemoteDataEx . ... . ... . ... . ... . ... . ... . .... .... .... .... .... .... .... .... .... .... .. 31

Exemple de code Visual Basic pour la fonction distant .... .... .... .... ... 32

Méthodes CHostDataManager ... .... .... .... .... .... .... .... .... . ... . ... . ... . ... . ... . 34

Propriétés CHostData .... .... .... .... .... .... .... .... . ... . ... . ... . ... . ... . ... . ... . ... . .. 37

Propriétés du type de connexion .... .... .... .... .... .... .... .... .... .... .... ... 39

Méthode AssignConnection(type de connexion) ... .... .... .... .... .... .... 42

Méthode UnassignConnection (type de connexion) ... . ... . ... . ... . ... . ... 42

Table des matières8

Propriétés de numérotation . .... .... .... .... .... .... .... .... .... .... .... .... .... 43

Propriétés de périphérique COM .... .... .... .... .... .... .... .... .... .... .... ... 44

Propriétés de périphérique NetBIOS . .... .... .... .... .... .... .... .... .... .... . 47

Propriétés de périphérique RNIS via CAPI 2.0 ... .... .... .... .... .... .... ... 48

objet CHostDataEx .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... ... 48

Exemple de code Visual Basic pour la fonctionnalité hôte. .... .... .... .. 56

fonctions awrem32 . .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .. 58

Chapitre 3 Définitions d'objets Visual C++ . .... .... .... .... .... .... .... .... .... ... 61

A propos des objets Visual C++ . .... .... .... .... .... .... .... .... .... .... .... .... .... .. 61

Méthodes CRemoteDataManager .... .... .... .... .... .... .... .... .... .... .... .... .... 62

objet CRemoteData . . ... . ... . ... . ... . ... . ... . ... . .... .... .... .... .... .... .... .... .... .... . 66

Méthodes Get et Set (obtenir et définir) ... .... .... .... .... .... .... .... .... ... 66

Méthodes de détail d'objet distant .... .... .... .... .... .... .... .... .... .... .... . 68

Méthodes d'objet distant ... .... .... .... .... .... .... .... .... .... .... .... .... .... .. 71

objet CRemoteDataEx . ... . ... . ... . ... . ... . ... . .... .... .... .... .... .... .... .... .... .... .. 72

Exemple de code Visual C++ pour la fonctionnalité du

distant .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... ... 72

Méthodes CHostDataManager ... .... .... .... .... .... .... .... .... . ... . ... . ... . ... . ... . 73

objet CHostData . .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .. 77

Méthodes Get et Set (obtenir et définir) ... .... .... .... .... .... .... .... .... ... 77

Méthodes de détail d'objet hôte . .... .... .... .... .... .... .... .... .... .... .... .... 79

Méthodes d'objet hôte .... .... .... .... .... .... . ... . ... . ... . ... . ... . ... . ... . ... . .... 83

objet CHostDataEx .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... ... 85

Exemple de code Visual C++ pour la fonctionnalité Hôte ... . ... . ... . ... . 87

fonctions awrem32 . .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .. 88

Index ... . ... . ... . ... . ... . ... . .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... 91

Chapitre

Utilisation de l'automatisation OLE avec Symantec pcAnywhere

Ce chapitre traite des sujets suivants :

■ A propos de l'automatisation OLE

■ A propos du serveur d'automatisation pcAnywhere

■ Ce que vous pouvez faire avec le serveur d'automatisation pcAnywhere

1

■ Avant de commencer

■ Pour plus d'informations

A propos de l'automatisation OLE

L'automatisation OLE est une technologie qui permet de créer une application
externe ou un autre outil de développement (par exemple unscript ou une macro)
capable de contrôler et d'automatiser toute fonction exposée d'une application.

L'automatisation OLE est constituée des composants suivants :

un serveur d'automatisation
OLE ;

une application ou composant logiciel qui expose sa
fonction afin d'être accessible ou de pouvoir être contrôlé
par d'autres applications ou d'autres outils de
développement.

Le serveur d'automatisation pcAnywhere est un exemple
de serveur d'automatisation OLE ;

Utilisation de l'automatisation OLE avec Symantec pcAnywhere

10

A propos du serveur d'automatisation pcAnywhere

un contrôleur
d'automatisation OLE ;

Une application externe accède à un serveur d'automatisation en se connectant
au serveur,puis en demandant l'accès à une ouplusieurs deses interfacespubliées.
Une interface est un point d'entrée permettant d'accéder à une ou plusieurs
méthodes ou propriétés rattachées. Une fois que l'application a obtenu une
interface vers le serveur, elle peut appeler toute méthode d'interface comme si
celle-ci faisait partie de l'application externe.

une application ou outil de développement pouvant
atteindre etcontrôler lescomposants exposéspar leserveur
d'automatisation OLE.

Vous pouvez utiliser tout langage de programmation
prenant encharge l'automatisationOLE. Lesdeux langages
de programmation les plus courants sont Microsoft Visual
Basic et Microsoft Visual C++.

A propos du serveur d'automatisation pcAnywhere

Le serveur d'automatisation pcAnywhere permet aux applications externes de
gérer les fichiers pcAnywhere Hôte et Distant afin d'automatiser les tâches de
téléintervention et de transfert de fichiers. Le serveur d'automatisation
pcAnywhere fonctionne comme un substitut programmable de l'interface
utilisateur de Symantec pcAnywhere et reprend dans une large mesure son
comportement par défaut.

Par exemple,lorsque vouscréez unobjet hôtedans pcAnywhere,le premiermodem
TAPI disponible est attribué par défaut. De même, si vous créez un objet hôte à
l'aide du serveur d'automatisation pcAnywhere, puis que vous énumérez la liste
des connexions attribuées, le premier modem TAPI disponible est déjà attribué.

Ce que vous pouvez faire avec le serveur d'automatisation pcAnywhere

Le serveur d'automatisation pcAnywhere vous permet d'automatiser diverses
tâches administratives et de productivité.

Vous pouvez utiliser serveur d'automatisation pcAnywhere pour effectuer les
actions suivantes :

■ Distribution et installation automatiques de mises à jour logicielles sur

plusieurs ordinateurs du réseau

■ Programmation detransferts automatiques de fichiers entre ordinateurs à des

fins d'audit ou d'archivage

■ Ajouter ou supprimer automatiquement un nom de la liste des appelants sur

chaque hôte pcAnywhere de votre réseau

Ce document comporte plusieurs exemples, écrits à la fois en Visual Basic et en
Visual C++,afin d'illustrer la manière de se connecterau serveurd'automatisation
pcAnywhere et de l'utiliser.

Se reporter à "A propos des objets Visual Basic" à la page 17.

Se reporter à "A propos des objets Visual C++" à la page 61.

Avant de commencer

Au cours d'une connexion au serveur d'automatisation pcAnywhere et à ses
interfaces, les paramètres d'identification, appelés GUID (Globally Unique
Identifiers - identificateurs globalement uniques), sont transmis aux fonctions
API de la bibliothèque d'automatisation. Un GUID distinctest attribué au serveur
d'automatisation pcAnywhere et à chaque interface exposée. Ces GUID doivent
être présents dans le registre système pour connecter une application externe au
serveur d'automatisation pcAnywhere et à ses interfaces.

Si vous exécutez l'application externe sur un ordinateur sur lequel Symantec
pcAnywhere estinstallé, vouspouvez inscrire automatiquement les entrées GUID.
Dans le cas contraire, vous devez enregistrer les entrées GUID manuellement.

Se reporter à "Inscription automatique du moteur distant" à la page 11.

Se reporter à "Inscription manuelle du moteur distant" à la page 12.

Avant de commencer

11Utilisation de l'automatisation OLE avec Symantec pcAnywhere

Inscription automatique du moteur distant

Avant de vous connecter à un autre ordinateur pour la première fois en utilisant
votre client OLE, vous devez inscrire automatiquement le moteur distant. Cette
opération peut s'effectuer automatiquement lorsque vous démarrez un objet
distant dans Symantec pcAnywhere.

Pour inscrire automatiquement le moteur distant

Pour ouvrirSymantec pcAnywhere, effectuez l'une des opérations suivantes :

1

■ Sur le bureau, cliquez deux fois sur l'icône du programme Symantec

pcAnywhere.

Utilisation de l'automatisation OLE avec Symantec pcAnywhere

12

Avant de commencer

■ Dans la barre des tâches de Windows, cliquez sur Démarrer>

Programmes> Symantec pcAnywhere.

Dans la fenêtre du Gestionnaire pcAnywhere, cliquez sur Distants.

2

Cliquez deux fois sur un élément de connexion distante.

3

Cette procédure inscrit le moteur distant. Il n'est pas nécessaire de terminer
la connexion.

Inscription manuelle du moteur distant

Si pcAnywhere n'est pas installé sur l'ordinateur sur lequel vous exécutez
l'application externe, vous devez inscrire manuellement les GUID en exécutant
le fichier exécutable (winawsvr.exe) du serveur d'automatisation pcAnywhere. Il
suffit de lancer l'exécutable une seule fois pour ajouter les GUID au registre. Le
fichier Winawsvr.exe se trouve dans le répertoire d'installation.

Accès au serveur d'automatisation pcAnywhere

Vous pouvez accéder au serveur d'automatisation de pcAnywhere en utilisant
toute plate-formeprenant encharge l'automatisation OLE. Les deux plates-formes
les plusrépandues quiprennent en charge l'automatisation OLE sont Visual Basic
et Visual C++.

Les principes de codage de ces deux plates-formes sont similaires, bien que dans
l'environnement Visual Basic une part importante des tâches de bas niveau est
exécutée en arrière-plan par l'exécutable Visual Basic.

Accès au serveur d'automatisation pcAnywhere avec Visual Basic

Le langage de programmation Visual Basic intègre la prise en charge de
l'interaction avec les serveurs d'automatisation OLE tels que le serveur
d'automatisation pcAnywhere. Vous pouvez créer un projet Exe standard puis,
dans chaque méthode, entrer le code pour accéder au serveur d'automatisation
pcAnywhere. Visual Basic prend les appels de méthode de haut niveau dans les
fichiers source et les développe de façon interne dans les appels de méthode de
bas niveau correspondants de l'automatisation OLE.

Avant de commencer

Pour accéder au serveur d'automatisation pcAnywhere avec Visual Basic

Ajoutez une paire de variables objet pour chaque objet pcAnywhere auquel

1

accéder.

Par exemple, pour travailler avec des objets distant, dimensionnez un objet

RemoteDataManager et RemoteDataObject.

Utilisez RemoteDataManagerpour lerattachement augestionnaire dedonnées

2

de l'objet distant.

Par exemple, appelez la méthode CreateObject avec

WINAWSVR.REMOTEDATAMANAGER comme paramètre.

Visual Basic utilise le paramètre textuel pour repérer l'identificateur du

gestionnaire dans la base de registres et renvoie l'interface vers ce

gestionnaire.

Une fois qu'il existe un objet gestionnaire de données valide, utilisez-le pour

3

effectuer les opérations suivantes :

■ Déterminer le répertoire en cours

■ Accéder à un autre répertoire

■ Enumérer lesfichiers objet de données associés dans le répertoire encours

13Utilisation de l'automatisation OLE avec Symantec pcAnywhere

■ Créer, extraire ou supprimer un fichier objet de données

Après la création ou la récupération d'un objet de données, vous pouvez

4

obtenir (Get) ou définir (Set) ses propriétés.

La syntaxede Visual Basic n'utilise pas de nom de propriété pour différencier

l'obtention et la définition de sa valeur. C'est la position de la propriété par

rapport à l'opérateur d'affectation qui détermine si l'appel de méthode

sous-jacent est un Get ou un Set.

Les exemples suivants illustrent un Get et un Set :

■ Pour obtenir la valeur du numéro de téléphone d'un objet, placez le nom

de la propriété à droite de l'opérateur d'affectation.
Par exemple, s = RemoteData.PhoneNumber(), où s est une variable de

type chaîne.

■ Pour configurer le numéro de téléphone, placez le nom de la propriété à

gauche de l'opérateur d'affectation.
Par exemple, RemoteData.PhoneNumber = "555-1212"

Utilisation de l'automatisation OLE avec Symantec pcAnywhere

14

Avant de commencer

Accès au serveur d'automatisation pcAnywhere avec Visual C++

Le serveur d'automatisation pcAnywhere utilise des bibliothèques de type pour
exposer lesinformations concernant ses interfaces et ses méthodes vers lesclients
d'automatisation, quisont écrits en Visual C++. Ces bibliothèquesde type utilisent
des MFC (Microsoft Foundation Classes), qui peuvent être importées dans votre
application via l'assistant ClassWizard de Visual C++.

Les classes du gestionnaire de données fournies dans les bibliothèques de type
contiennent la fonction nécessaire pour obtenir une interface vers le serveur
d'automatisation pcAnywhere et effectuer des opérations de haut niveau sur le
type d'objet associé à l'interface.

Utiliser l'objet gestionnaire de données pour effectuer les opérations suivantes :

■ Déterminer ou modifier le répertoire en cours.

■ Enumérer les fichiers objet de données du répertoire en cours.

■ Créer, extraire ou supprimer un objet nommé.

Une fois créé ou récupéré, un objet utilise la classe d'objet de données associée
pour examiner ou modifier ses propriétés exposées. La plupart de ces propriétés
sont exposées à travers une paire de méthodes qui commencent par le mot Get
ou Set. Par exemple, un utilisateur appelle la méthode GetPhoneNumber pour
examiner la propriété de numéro de téléphone en cours de l'objet et appelle
SetPhoneNumber pour la définir.

Importation et affichage des classes

Le serveur d'automatisation pcAnywhere utilise les bibliothèques de type
suivantes :

Winawsvr.tlb

Awrem32.tlb

Les procéduressuivantes expliquent comment importer les bibliothèques detype
du serveurd'automatisation pcAnywhere et afficher les classes ayantété ajoutées
à votre application.

Pour importer des classes

Créez une application MFC dans Visual C++.

1

Dans le menu Affichage, cliquez sur Assistant de classe.

2

Contient les informations nécessaires pour se connecter au serveur
d'automatisation pcAnywhere et accéder à ses interfaces.

Contient les informations nécessaires au contrôle des connexions
pcAnywhere.

Avant de commencer

Dans la boîte de dialogue Assistant de classe, cliquez sur Ajouterune classe,

3

puis cliquez sur Depuis une bibliothèque de type.

Cliquez deux fois sur winawsvr.tlb.

4

Dans la boîte de dialogue Confirmer Classes, cliquez sur OK pour importer

5

toutes les définitions de classe.

Dans la boîte de dialogue Assistant de classe, cliquez sur Ajouterune classe,

6

puis cliquez sur Depuis une bibliothèque de type.

Cliquez deux fois sur awrem32.tlb.

7

Dans la boîte de dialogue Confirmer Classes, cliquez sur OK pour importer

8

toutes les définitions de classe.

Dans la boîte de dialogue Assistant de classe, cliquez sur OK pour terminer

9

l'importation.

Les classes sont ajoutées à l'application. Elles vous permettent de manipuler

des objets et de gérer des connexions.

L'importation des définitions de classe à partir des bibliothèques de type

ajoute également des fichiers de prise en charge à l'application. Ces fichiers

contiennent les définitions de classe et le code source de mise en oeuvre du

serveur d'automatisation pcAnywhere.

Se reporter à "Affichage des définitions de classe et des fichiers de mise en

oeuvre" à la page 15.

Pour afficher les classes ajoutées

15Utilisation de l'automatisation OLE avec Symantec pcAnywhere

Dans Visual C++, ouvrez votre application MFC.

1

Dans la fenêtre de l'espace de travail, cliquez sur l'onglet ClassView.

2

Affichage des définitions de classe et des fichiers de mise en
oeuvre

Lorsque vous importez les bibliothèques de type du serveur d'automatisation
pcAnywhere dans votre application, les fichiers suivants sont ajoutés :

■ Winawsvr.h

■ Winawsvr.cpp

■ Awrem32.h

■ Awrem32.cpp

Ces fichiers contiennent les définitions de classe et le code source de mise en
oeuvre duserveur d'automatisation pcAnywhere. Il est inutile d'éditerces fichiers;

Utilisation de l'automatisation OLE avec Symantec pcAnywhere

16

Pour plus d'informations

cependant, chaque fichier source de l'application contenant des appels des
méthodes du serveur d'automatisation pcAnywhere doit inclure Winawsvr.h.

Pour afficher les définitions de classe et les fichiers de mise en oeuvre

Dans Visual C++, ouvrez votre application MFC.

1

Dans la fenêtre de l'espace de travail, cliquez sur l'onglet FileView.

2

Démarrage des objets OLE hôte et distant

Symantec pcAnywhere nécessite que tous les objetshôte et distant soient stockés
dans le répertoire de données par défaut. Avant de démarrer un objet hôte ou
distant que vous avez créé avec OLE, vérifiez qu'il se trouve dans le répertoire de
données par défaut de pcAnywhere. Le répertoire par défaut est le dossier All
Users dans Windows XP, et le dossier ProgramData dans Vista.

Pour plus d'informations

Pour plus d'informations sur l'automatisationOLE, reportez-vousaux documents
de référence suivants (en anglais) :

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

■ Horton, Ivor. 1997. Commencer MFC Programming. Birmingham, RU : Wrox

Press.

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

■ Templeman, Julian. 1997. Beginning MFC COM Programming. Birmingham,

RU : Wrox Press.

Chapitre

Définitions d'objets Visual Basic

Ce chapitre traite des sujets suivants :

■ A propos des objets Visual Basic

■ Méthodes CRemoteDataManager

■ Propriétés CRemoteData

■ objet CRemoteDataEx

2

■ Méthodes CHostDataManager

■ Propriétés CHostData

■ objet CHostDataEx

■ fonctions awrem32

A propos des objets Visual Basic

Le serveur d'automatisation pcAnywhere offre les composants suivants pour la
prise en charge de l'automatisation OLE :

Winawsvr

Awrem32

Le Tableau 2-1 décrit les objets qui composent Winawsvr.

contient les informations nécessaires pour se connecter au serveur
d'automatisation pcAnywhere et accéder à ses interfaces.

Contient les informations nécessaires au contrôle des connexions
pcAnywhere.

Définitions d'objets Visual Basic

18

Méthodes CRemoteDataManager

CRemoteDataManager

CRemoteData

CHostDataManager

CHostData

Tableau 2-1

Objets Winawsvr

RéférenceDescriptionObjet

Fournit les méthodes pour créer, ouvrir,
modifier, enregistrer et supprimer les
objets CRemoteData.

Définit les paramètres permettant
d'accéder à la fonction distant de
pcAnywhere et de la contrôler.

Fournit les méthodes pour créer, ouvrir,
modifier, enregistrer et supprimer les
objets ChostData.

Définit les paramètres permettant
d'accéder àla fonctionhôte depcAnywhere
et de la contrôler.

Se reporter à "Méthodes

CRemoteDataManager" à la page 18.

Se reporter à "Propriétés CRemoteData"
à la page 21.

Se reporter à "objet CRemoteDataEx"
à la page 31.

Se reporter à "Méthodes

CHostDataManager" à la page 34.

Se reporter à "Propriétés CHostData"
à la page 37.

Se reporter à "objet CHostDataEx"
à la page 48.

Awrem32 possède un objet, constitué de huit interfaces, pour prendre en charge
les sessions de téléintervention et de transfert de fichiers.

Se reporter à "fonctions awrem32" à la page 58.

Quelques fonctions ne sont plus prises en charge. Cependant, les définitions
d'objets sont utilisables avec les versions antérieures de pcAnywhere.

Pour les fonctions nécessitant des mots de passe, les valeurs des mots de passe
peuvent être définies mais non récupérées, pour des raisons de sécurité.

Méthodes CRemoteDataManager

Les méthodes CRemoteDataManager fournissent les paramètres et renvoient les
valeurs permettant d'accéder aux objets CRemoteData et de les contrôler.

Tableau 2-2

Méthode
CRemoteDataManager

CurrentDirectory()

Méthodes CRemoteDataManager

renvoyés

Valeur renvoyée =
chaîne

DescriptionParamètre ou valeur

Renvoie le chemin d'accès complet
du dossier actuel dans lequel les
objets distants pcAnywhere sont
stockés.

Méthodes CRemoteDataManager

19Définitions d'objets Visual Basic

Méthode
CRemoteDataManager

ChangeDirectory(nouveau
répertoire)

FindFirst(schéma)

FindFirst(nom)

FindNext(nom)

FindNext(nom)

renvoyés

Paramètre =
NewDirectory

Paramètre =schéma en
tant que chaîne

Paramètre = Nom
comme chaîne

Paramètre = Nom
comme chaîne

Valeur renvoyée =
booléen

DescriptionParamètre ou valeur

Change ledossier actueldans lequel
les objetsdistants pcAnywheresont
stockés.

Trouve le premier fichier d'objet
distant de pcAnywhere (*.chf) dans
le rdossieren cours; classeles noms
de fichiers de schémas sur base du
schéma spécifié de nom de fichier
(un astérisque[*] permet detrouver
tous lesfichiers dudossier encours)

Tampon de retour pour le chemin
d'accès complet du fichier d'objet
distant (*chf) correspondant au
schéma spécifié

Tampon de retour pour le chemin
d'accès complet du fichier d'objet
distant correspondant au schéma
spécifié dans l'appel initial de
FindFirst().

VRAI si un autre fichier d'objet
distant correspondant au schéma
spécifié dans l'appel de FindFirst()
est trouvé. Le chemin d'accès
complet du fichier est stocké dans
Nom.

RetrieveObject(nom)

RetrieveObject(mode
d'accès)

RetrieveObject(mot de
passe)

Paramètre = Nom
comme chaîne

Paramètre = Mode
d'accès comme valeur
entière

Paramètre = Mot de
passe comme chaîne

Nom intégralement qualifié du
fichier d'objet distant à charger.

Spécifie commentcet objetdoit être
utilisé. Ce paramètre est lié à la
protection par mot de passe.

Les options sont les suivantes :

■ 0 = Non spécifié

■ 1 = Afficher uniquement

■ 2 = Afficher et modifier

■ 3 = Exécuter

Mot de passe de l'objet. Peut être
NULL.

Définitions d'objets Visual Basic

20

Méthodes CRemoteDataManager

Méthode
CRemoteDataManager

RetrieveObjectEx(nom)

RetrieveObjectEx(mode
d'accès)

RetrieveObjectEx(mot de
passe)

RetrieveObjectEx

CreateObject(nom)

renvoyés

Paramètre = Nom
comme chaîne

Paramètre = Mode
d'accès comme valeur
entière

Paramètre = Mot de
passe comme chaîne

Valeur renvoyée =
Objet

Paramètre = Nom
comme chaîne

DescriptionParamètre ou valeur

Nom intégralement qualifié du
fichier d'objet distant à charger.

Spécifie commentcet objetdoit être
utilisé. Ce paramètre est lié à la
protection par mot de passe.

Les options sont les suivantes :

■ 0 = Non spécifié

■ 1 = Afficher uniquement

■ 2 = Afficher et modifier

■ 3 = Exécuter

Mot de passe de l'objet. Peut être
NULL.

Objet CRemoteDataEx du fichier
spécifié.

Crée un objet CRemoteData et
renvoie un pointeur LPDISPATCH
qui le désigne. Le paramètre est le
nom defichier entièrementqualifié
d'objet distant pour le nouvel objet.

CreateObject

CreateObjectEx(nom)

CreateObjectEx

DeleteObject(nom)

DeleteObject(mot de passe)

DeleteObject

Objet

Paramètre = Nom
comme chaîne

Objet

Paramètre = Nom
comme chaîne

passe comme chaîne

booléen

CRemoteDataValeur renvoyée =

Crée un objet CRemoteDataEx et
renvoie un pointeur LPDISPATCH
qui le désigne. Le paramètre est le
nom defichier entièrementqualifié
d'objet distant pour le nouvel objet.

CRemoteDataExValeur renvoyée =

Nom intégralement qualifié du
fichier d'objet distant de l'objet à
supprimer.

Mot de passe de l'objetParamètre = Mot de

VRAI si l'objet est supprimé.Valeur renvoyée =

Propriétés CRemoteData

Les propriétéset lesparamètres disponiblespour l'objet CRemoteData sont affichés
comme suit.

Dans Tableau 2-3, remplacez les informations entre les chevrons par les valeurs
réelles.

Propriétés CRemoteData

21Définitions d'objets Visual Basic

Tableau 2-3

CRemoteData - Propriétés et paramètres

DescriptionParamètrePropriété

Chaîne<CRemoteData>.ComputerName(chaîne)

Chaîne<CRemoteData>.PhoneNumber(chaîne)

Bool<CRemoteData>.UseDialingProperties(Bool)

Entier<CRemoteData>.RedialCount(entier)

Entier<CRemoteData>.RedialDelay(entier)

Chaîne<CRemoteData>.AutoLoginName(chaîne)

Chaîne<CRemoteData>.AutoLoginPassword(chaîne)

Définit le nom ou l'adresse IP de l'ordinateur
hôte.

Définit lenuméro detéléphone del'ordinateur
hôte.

Définit les propriétés de numérotation du
système.

Définit lenombre detentatives derappel avant
l'annulation de l'appel.

Définit le nombre de secondes d'attente entre
les tentatives de rappel.

Définit le nom de l'utilisateur pour la
connexion automatique.

Pour plusd'informations surl'utilisation de la
connexion aux domaines, reportez-vous à la
section :

Se reporter à "objet CRemoteDataEx"
à la page 31.

Définit le mot de passe pour la connexion
automatique dans l'objet distant.

Pour des raisons de sécurité, le serveur
d'automatisation pcAnywhere ne permet pas
de lire la valeur du mot de passe. Aucune
valeur de mot de passe n'est renvoyée.

Définitions d'objets Visual Basic

22

Propriétés CRemoteData

DescriptionParamètrePropriété

Chaîne<CRemoteData>.Password(chaîne)

Bool<CRemoteData>.ExecuteProtection (Bool)

Bool<CRemoteData>.ReadProtection(Bool)

Bool<CRemoteData>.WriteProtection(Bool)

Bool<CRemoteData>.LogSession (Bool)

Chaîne<CRemoteData>.RecordFile(chaîne)

Bool<CRemoteData>.RecordSession(Bool)

Définit le mot de passe sur l'objet distant, à
utiliser avec les méthodes ExecuteProtection,
ReadProtection et WriteProtection.

Pour des raisons de sécurité, le serveur
d'automatisation pcAnywhere ne permet pas
de lire la valeur du mot de passe. Aucune
valeur de mot de passe n'est renvoyée.

Définit la nécessité d'un mot de passe pour
exécuter l'objet. Définir par mot de passe.

Définit la nécessité d'un mot de passe pour
afficher lespropriétés del'objet distant.Définir
par mot de passe.

Définit la nécessité d'un mot de passe pour
enregistrer les modification de l'objet distant.
Définir par mot de passe.

Active et désactive la consignation des
sessions.

Définit le nom et le chemin d'accès
intégralement qualifié du fichier
d'enregistrement de la session active.

Active et désactive la consignation
automatique de session.

Chaîne<CRemoteData>.ReadObject(chaîne)

Chaîne<CRemoteData>.WriteObject(chaîne)

Définit le mot de passe de l'objet. Utilisez cette
propriété pour actualiser la copie locale des
données de l'objet distant.

Définit le mot de passe de l'objet. Utilisez cette
propriété pour créer l'objet distant ou pour
écrire les changements apportés à celui-ci.

Les propriétés et les valeurs renvoyées pour CRemoteData sont affichées dans le
tableau suivant.

Dans Tableau 2-4, remplacez les informations entre les chevrons par les valeurs
réelles.

Propriétés CRemoteData

23Définitions d'objets Visual Basic

Propriété

Tableau 2-4

CRemoteData - Propriétés et valeurs renvoyées

DescriptionValeur

renvoyée

ChaîneString = <CRemoteData>.ComputerName

ChaîneString = <CRemoteData>.PhoneNumber

BoolBool = <CRemoteData>.UseDialingProperties

EntierInteger = <CRemoteData>.RedialCount

EntierInteger = <CRemoteData>.RedialDelay

ChaîneString = <CRemoteData>.AutoLoginName

BoolBool = <CRemoteData>.ExecuteProtection

BoolBool = <CRemoteData>.ReadProtection

Renvoie le nom ou l'adresse IP de l'ordinateur
hôte

Renvoie lenuméro detéléphone del'ordinateur
hôte

Renvoie les propriétés de numérotation du
système définies dans l'objet distant

Renvoie lenombre de tentativesd'appel défini
dans l'objet distant

Renvoie lenombre desecondes d'attenteentre
les tentatives de rappel.

Renvoie le nom de l'utilisateur pour la
connexion automatique

Renvoie la valeur du paramètre
ExecuteProtection.

Renvoie la valeur du paramètre
ReadProtection.

BoolBool = <CRemoteData>.WriteProtection

ChaîneString = <CRemoteData>.RecordFile

BoolBool = <CRemoteData>.RecordSession

Propriétés du type de connexion

Le tableau suivant décrit les propriétés et les paramètres du type de connexion.

Dans Tableau 2-5, remplacez les informations entre les chevrons par les valeurs
réelles.

Renvoie la valeur du paramètre
WriteProtection

VRAI si la consignation de session est activée.BoolBool = <CRemoteData>.LogSession

Renvoie le nom et le chemin d'accès
intégralement qualifié du fichier
d'enregistrement de la session.

Renvoie la valeur du paramètre
d'enregistrement de session.

Définitions d'objets Visual Basic

24

Propriétés CRemoteData

Tableau 2-5

Type de connexion - Propriétés et paramètres

DescriptionParamètrePropriété

Chaîne<CRemoteData>.ConnectionType(chaîne)

Définit le type de connexion de l'ordinateur
distant. La valeur transmise doit être un type
de connexion valide, défini par les fonctions
FirstConnectionType() et
NextConnectionType().

Les types suivants sont des exemples de
connexions valides :

■ COM1

■ COM2

■ COM3

■ COM4

■ TCP/IP

■ SPX

■ NetBIOS

■ RNIS via CAPI 2.0

■ Nom du modem (tel qu'il apparaît sur

l'ordinateur)

Le tableau suivant décrit les propriétés et les valeurs renvoyées pour le type de
connexion.

Dans Tableau 2-6, remplacez les informations entre les chevrons par les valeurs
réelles.

Propriété

Tableau 2-6

Type de connexion - Propriétés et valeurs renvoyées

DescriptionValeur

renvoyée

Renvoie letype deconnexion del'objet distant.ChaîneString = <CRemoteData>.ConnectionTypes

Propriétés CRemoteData

25Définitions d'objets Visual Basic

Propriété

renvoyée

EntierInteger = <CRemoteData>.ConnectionType

ChaîneString = <CRemoteData>.FirstConnectionType

ChaîneString = <CRemoteData>.NextConnectionType

DescriptionValeur

Renvoie le nombre de types de connexion
disponibles.

Les types suivants sont des exemples de
connexions valides :

■ COM1

■ COM2

■ COM3

■ COM4

■ TCP/IP

■ SPX

■ NetBIOS

■ RNIS via CAPI 2.0

■ Nom du modem (tel qu'il apparaît sur

l'ordinateur)

Renvoie le premier type de connexion
disponible.

Renvoie le type de connexion disponible
suivant. L'appel s'effectue de façon
séquentielle pour le nombre de types de
connexion défini dans
<CRemoteData>.ConnectionType, afin
d'énumérer tous les types de connexion.

de connexion)

Propriétés de numérotation

Le tableausuivant décrit les propriétés et les paramètrespour définirles propriétés
de numérotation pour les connexions par modem.

Dans Tableau 2-7, remplacez les informations entre les chevrons par les valeurs
réelles.

BoolBool =<CRemoteData>.FindConnectionType(type

VRAI si le type de connexion indiqué a été
trouvé dans la liste des types de connexion
disponibles.

Définitions d'objets Visual Basic

26

Propriétés CRemoteData

Propriété

Tableau 2-7

Propriétés de numérotation - Propriétés et paramètres

DescriptionParamètrePropriété

Chaîne<CRemoteData>.AreaCode(chaîne)

Chaîne<CRemoteData>.CountryCode(chaîne)

Définit lespropriétés denumérotation decode
de zone pour les connexions par modem

Définit les propriétés de numérotation
d'indicatif international pour les connexions
par modem

Le tableausuivant définit les propriétés et les valeursrenvoyées pourles propriétés
de numérotation par modem.

Dans Tableau 2-8, remplacez les informations entre les chevrons par les valeurs
réelles.

Tableau 2-8

Propriétés de numérotation - Propriétés et valeurs renvoyées

DescriptionValeur

renvoyée

ChaîneString = <CRemoteData>.AreaCode

ChaîneString= <CRemoteData>.CountryCode

EntierInteger = <CRemoteData>.CountryCodes

Renvoie lespropriétés denumérotation de code
de zone

Renvoie les propriétés de numérotation
d'indicatif international

Renvoie lenombre d'indicatifsinternationaux
disponibles.

ChaîneString= <CRemoteData>.FirstCountryCode

ChaîneString= <CRemoteData>.NextCountryCode

Propriétés de périphérique COM

Le tableau suivant définit les propriétés et les paramètres qui vous permettent
de personnaliserles paramètres de port du modem etdes autresconnexions COM.

Dans Tableau 2-9, remplacez les informations entre les chevrons par les valeurs
réelles.

Renvoie le premier indicatif de pays
apparaissant dans la liste du système
d'exploitation.

Renvoie l'indicatif international disponible
suivant. L'appel s'effectue de façon
séquentielle pour le nombre d'indicatifs
internationaux défini dans
<CRemoteData.CountryCodes>, afin
d'énumérer tousles indicatifs internationaux.

Propriétés CRemoteData

27Définitions d'objets Visual Basic

Tableau 2-9

Périphérique COM - Propriétés et paramètre

DescriptionParamètrePropriété

Chaîne<CRemoteData>.ComParity(chaîne)

Chaîne<CRemoteData>.ComFlowControl(chaîne)

Chaîne<CRemoteData>.ComStartedBy(chaîne)

Définit la parité des communications.

Les valeurs suivantes sont valides :

■ <Aucun>

■ Impaire

■ Paire

■ Marque

■ Espace

Définit le contrôle de flux des types de
connexion COM.

Les valeurs suivantes sont valides :

■ <Aucune>

■ XONXOFF

■ RTS/CTS

■ Les deux

Définit le paramètre de début des types de
connexion COM.

Les valeurs suivantes sont valides :

■ Toujours connecté

■ Détection de porteuse (DCD)

■ Prêt à émettre (CTS)

■ Ensemble de données prêt (DSR)

■ Signal de sonnerie (RI)

■ Réception 2 <RC>

■ Réponse du modem

Chaîne<CRemoteData>.ComEndedBy(chaîne)

Définit le paramètre de fin des types de
connexion COM.

Les valeurs suivantes sont valides :

■ Toujours connecté

■ Détection de porteuse (DCD)

■ Prêt à émettre (CTS)

■ Ensemble de données prêt (DSR)

■ Signal de sonnerie (RI)

Définitions d'objets Visual Basic

28

Propriétés CRemoteData

DescriptionParamètrePropriété

Propriété

Long<CRemoteData>.ComSpeed(Long)

Contient le paramètre de vitesse COM
maximale

Les valeurs suivantes sont valides :

■ 110

■ 300

■ 600

■ 1200

■ 2400

■ 4800

■ 9600

■ 38400

■ 57600

■ 115200

Le tableausuivant décrit les propriétés et les valeursrenvoyées parle périphérique
COM.

Dans Tableau 2-10, remplacez les informations entre les chevrons par lesvaleurs
réelles.

Tableau 2-10

Périphériques COM - Propriétés et valeurs renvoyées

DescriptionValeur

renvoyée

ChaîneString = <CRemoteData>.ComParity

Renvoie l'une des valeurs suivantes comme
parité de communications :

■ <Aucune>

■ Impaire

■ Paire

■ Marque

■ Espace

ChaîneString = <CRemoteData>.ComFlowControl

Renvoie le paramètre de contrôle de flux de
l'objet distant.

Les valeurs suivantes sont valides :

■ <Aucun>

■ XONXOFF

■ RTS/CTS

■ Les deux

Propriétés CRemoteData

29Définitions d'objets Visual Basic

Propriété

renvoyée

ChaîneString = <CRemoteData>.ComStartedBy

ChaîneString = <CRemoteData>.ComEndedBy

LongLong = <CRemoteData>.ComSpeed

DescriptionValeur

Renvoie le contrôle de début des types de
connexion COM.

Les valeurs suivantes sont valides :

■ Toujours connecté

■ Détection de porteuse (DCD)

■ Prêt à émettre (CTS)

■ Ensemble de données prêt (DSR)

■ Signal de sonnerie (RI)

■ Réception 2 <RC>

■ Réponse du modem

Renvoie le contrôle de fin des types de
connexion COM

Les valeurs suivantes sont valides :

■ Toujours connecté

■ Détection de porteuse (DCD)

■ Prêt à émettre (CTS)

■ Ensemble de données prêt (DSR)

■ Signal de sonnerie (RI)

Renvoie le paramètre de vitesse de
communication de l'objet distant

Les valeurs suivantes sont valides :

■ 110

■ 300

■ 600

■ 1200

■ 2400

■ 4800

■ 9600

■ 38400

■ 57600

■ 115200

Propriétés de périphérique NetBIOS

Le tableausuivant définit les propriétés et les paramètres d'un périphériqueréseau
NetBIOS.

Définitions d'objets Visual Basic

30

Propriétés CRemoteData

Dans Tableau 2-11, remplacez les informations entre les chevrons par lesvaleurs
réelles.

Tableau 2-11

NetBIOS - Propriétés et paramètres

DescriptionParamètrePropriété

Entier<CRemoteData>.LanaNumber(entier)

Définit lenuméro d'adaptateurréseau (LANA)
à utiliser pour les connexions NetBIOS.

Le tableau suivant définit les propriétés et les valeurs renvoyées par NetBIOS.

Dans Tableau 2-12, remplacez les informations entre les chevrons par lesvaleurs
réelles.

Tableau 2-12

Propriété

Propriété NetBIOS et valeur renvoyée

DescriptionValeur

renvoyée

EntierInteger = <CRemoteData>.LanaNumber

Renvoie le paramètre en cours du numéro
LANA pour les connexions NetBIOS.

Propriétés de périphérique RNIS via CAPI 2.0

Le tableau suivant définit les propriétés et les paramètres pour les connexions
RNIS européennes.

Dans Tableau 2-13, remplacez les informations entre les chevrons par lesvaleurs
réelles.

Tableau 2-13

RNIS via CAPI 2.0 - Propriétés et paramètres

DescriptionParamètrePropriété

Bool<CRemoteData>.CapiChannelBonding(Bool)

Chaîne<CRemoteData>.CapiExtensions(chaîne)

Active ou désactive la liaison de canaux pour
les périphériques RNIS CAPI.

Définit toute extension CAPI supplémentaire
nécessaire pour les communications.

Le tableau suivant définit les propriétés et les valeurs renvoyées pour les
connexions RNIS européennes.

Dans Tableau 2-14, remplacez les informations entre les chevrons par lesvaleurs
réelles.

objet CRemoteDataEx

31Définitions d'objets Visual Basic

Tableau 2-14

RNIS via CAPI 2.0 - Propriétés et valeurs renvoyées

Propriété

objet CRemoteDataEx

L'objet CRemoteDataExcontient la même fonctionnalité quel'objet CRemoteData
avec une fonctionnalité supplémentaire.

Le tableau suivant décrit les propriétés et les paramètres.

Dans Tableau 2-15, remplacez les informations entre les chevrons par lesvaleurs
réelles.

Tableau 2-15

CRemoteDataEx - Paramètres

renvoyée

BoolBool= <CRemoteData>.CapiChannelBonding

ChaîneString = <CRemoteData>.CapiExtensions

Chaîne<CRemoteData>.PrivateKey (chaîne)

DescriptionValeur

Renvoie le paramètre de liaison de canaux
RNIS CAPI en cours dans l'objet distant.

Renvoie la liste actuelle des extensions CAPI
à partir de l'objet distant.

DescriptionParamètrePropriété

Définit le nom du conteneur de clé privée à
utiliser

Chaîne<CRemoteData>.CertificateName(chaîne)

Octet<CRemoteData>.AutoLoginPassword(octet)

Bool<CRemoteData>.DenyLowerEncrypt(Bool)

Chaîne<CRemoteData>.AutoDomain(chaîne)

Définit le nom commun de la clé privée à
utiliser.

Définit le niveau de chiffrement.

Les valeurs suivantes sont valides :

■ -1: Aucun

■ 0: pcAnywhere

■ 1: Symétrique

■ 2: Clé publique

Définit si l'ordinateur distant autorise une
connexion à un ordinateur hôte utilisant un
niveau de chiffrement inférieur.

Définit lenom dedomaine pourles connexions
automatiques. Cette option s'utilise avec les
types d'authentification NT et Windows.

Définitions d'objets Visual Basic

32

objet CRemoteDataEx

Le tableau suivant décrit les propriétés et les valeurs renvoyées pour l'objet
CRemoteDataEx.

Dans Tableau 2-16, remplacez les informations entre les chevrons par lesvaleurs
réelles.

Propriété

Tableau 2-16

CRemoteDataEx - Propriétés et valeurs renvoyées

DescriptionValeur

renvoyée

ChaîneString = <CRemoteData>.PrivateKey

ChaîneString = <CRemoteData>.CertificateName

OctetByte = <CRemoteData>.EncryptionLevel

BoolBool = <CRemoteData>.DenyLowerEncrypt

ChaîneString = <CRemoteData>.AutoDomain

Renvoie le nom du conteneur de clé privée
actuellement actif

Renvoie le nom commun du conteneur de clé
privée actif.

Renvoie l'un des paramètres de chiffrement
suivants :

■ -1: Aucun

■ 0: pcAnywhere

■ 1: Symétrique

■ 2: Clé publique

Renvoie la valeur du paramètre de rejet de
niveau de chiffrement inférieur.

Renvoie leparamètre de nom dedomaine pour
les connexions automatiques. Cette option
s'utilise avec les types d'authentification NT
et Windows.

Exemple de code Visual Basic pour la fonction distant

L'exemple de code Visual Basic suivant récupère un objet de données Distant et
modifie ses propriétés.

Private Sub Command1_Click()

Dim RemoteDataManager as Object

Dim RemoteData as Object

Dim s as string

''créer un objet CRemoteDataManager

Set RemoteDataManager = CreateObject(WINAWSVR.REMOTEDATAMANAGER)

objet CRemoteDataEx

''Afficher et modifier le répertoire en cours

s = RemoteDataManager.CurrentDirectory()

MsgBox (s)

RemoteDataManager.ChangeDirectory ("C:\dev\bin.w32\data")

s = RemoteDataManager.CurrentDirectory()

MsgBox (s)

''récupérer un objet de données distant

Set RemoteData = RemoteDataManager.RetrieveObjectEx("pod.CHF",

2, 0)

''afficher certaines propriétés

s = RemoteData.AreaCode()

MsgBox (s)

s = RemoteData.PhoneNumber()

MsgBox (s)

33Définitions d'objets Visual Basic

''définir certaines propriétés

RemoteData.AreaCode = "212"

RemoteData.PhoneNumber = "555-5555"

''écrire l'objet sur le disque

RemoteData.WriteObject (0)

End Sub

Utilisez les méthodes FindFirst et FindNext pour afficher le fichier distant dans
un répertoire, comme suit :

Private Sub Command5_Click()

Dim RemoteDataManager as Object

Dim RemoteData as Object

Dim s as string

Set RemoteDataManager =

CreateObject("WINAWSVR.REMOTEDATAMANAGER")

RemoteDataManager.ChangeDirectory

Définitions d'objets Visual Basic

34

Méthodes CHostDataManager

("C:\dev\bin.w32\data")

RemoteDataManager.FindFirst "*", s

MsgBox (s)

RemoteDataManager.FindNext s

MsgBox (s)

End Sub

Créez un objet distant. Définissez le type de connexion sur TCP/IP et le nom de
l'ordinateur sur "Host1". Lancez l'objet comme suit :

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

Méthodes CHostDataManager

Les méthodes CHostDataManager fournissent les paramètres et les valeurs
renvoyées pour accéder aux objets CHostData et les contrôler.

Méthode
CHostDataManager

CurrentDirectory()

valeur
renvoyés

Valeur renvoyée
= chaîne

DescriptionParamètre ou

Nom completde chemin d'accèsau dossier de
données pcAnywhereen coursdans lequelles
objets hôte pcAnywhere sont enregistrés.

Méthodes CHostDataManager

35Définitions d'objets Visual Basic

Méthode
CHostDataManager

FindFirst(schéma)

FindFirst(nom)

FindFirst

FindNext(nom)

FindNext

RetrieveObject(nom)

valeur
renvoyés

Paramètre =
schéma en tant
que chaîne

Paramètre =
Nom comme
chaîne

Valeur renvoyée
= booléen

Paramètre =
Nom comme
chaîne

Valeur renvoyée
= booléen

Paramètre =
Nom comme
chaîne

DescriptionParamètre ou

Schéma de nom de fichier pour filtrer les
fichiers d'objet (un astérisque [*] trouve tous
les fichiers dans le répertoire en cours).

Tampon de retour pour le chemin d'accès
complet dufichier d'objethôte correspondant
au schéma spécifié.

VRAI siun fichier d'objethôte correspondant
au schéma spécifié est trouvé. Le chemin
d'accès complet du fichier est stocké dans
Nom.

Tampon de retour pour le chemin d'accès
complet du fichier d'objet distant
correspondant auschéma spécifiédans l'appel
initial de FindFirst().

VRAI si un autre fichier d'objet hôte
correspondant auschéma spécifiédans l'appel
de FindFirst() est trouvé. Le chemin d'accès
complet du fichier est stocké dans Nom.

Nom intégralementqualifié dufichier d'objet
hôte à charger.

RetrieveObject(mode
d'accès)

RetrieveObject(mot de
passe)

RetrieveObject

Paramètre =
Mode d'accès
comme valeur
entière

de passe comme
chaîne

= Objet

Spécifie comment cet objet doit être utilisé.
Ce paramètre est lié à la protection par mot
de passe. Les options sont les suivantes :

■ 0 = Non spécifié

■ 1 = Afficher uniquement

■ 2 = Afficher et modifier

■ 3 = Exécuter

Mot de passe de l'objet. Peut être NULL.Paramètre =Mot

Objet CHostData du fichier spécifiéValeur renvoyée

Définitions d'objets Visual Basic

36

Méthodes CHostDataManager

Méthode
CHostDataManager

RetrieveObjectEx(nom)

RetrieveObjectEx(mode
d'accès)

RetrieveObjectEx(mot de
passe)

RetrieveObjectEx

CreateObject(nom)

valeur
renvoyés

Paramètre =
Nom comme
chaîne

Paramètre =
Mode d'accès
comme valeur
entière

de passe comme
chaîne

= Objet

Paramètre =
Nom comme
chaîne

DescriptionParamètre ou

Nom intégralementqualifié dufichier d'objet
hôte à charger.

Spécifie comment cet objet doit être utilisé.
Ce paramètre est lié à la protection par mot
de passe.

Les options sont les suivantes :

■ 0 = Non spécifié

■ 1 = Afficher uniquement

■ 2 = Afficher et modifier

■ 3 = Exécuter

Mot de passe de l'objet. Peut être NULL.Paramètre =Mot

Objet CHostDataEx du fichier spécifiéValeur renvoyée

Crée un objet CHostData et renvoie un
pointeur LPDISPATCH qui le désigne. Le
paramètre est le nom de fichier entièrement
qualifié d'objet distant pour le nouvel objet.

CreateObject

CreateObjectEx(nom)

CreateObjectEx

DeleteObject(nom)

DeleteObject(mot de
passe)

= Objet

Paramètre =
Nom comme
chaîne

= Objet

Paramètre =
Nom comme
chaîne

de passe comme
chaîne

CHostDataValeur renvoyée

Crée un objet CHostDataEx et renvoie un
pointeur LPDISPATCH qui le désigne. Le
paramètre est le nom de fichier entièrement
qualifié d'objet distant pour le nouvel objet.

CHostDataExValeur renvoyée

Nom intégralementqualifié dufichier d'objet
hôte de l'objet à supprimer.

Mot de passe de l'objetParamètre =Mot

Propriétés CHostData

37Définitions d'objets Visual Basic

Méthode
CHostDataManager

DeleteObject

Launch(nom)

Lancer

Propriétés CHostData

Le tableau suivant décrit les propriétés et les paramètres disponibles pour l'objet
CHostData.

Dans Tableau 2-17, remplacez les informations entre les chevrons par lesvaleurs
réelles.

Tableau 2-17

CHostData - Propriétés et paramètres

valeur
renvoyés

= booléen

Paramètre =
Nom comme
chaîne

= booléen

DescriptionParamètre ou

VRAI si l'objet est supprimé.Valeur renvoyée

Lance un fichier d'objet hôte, ce qui ouvre la
fenêtre de terminal de l'hôtepcAnywhere. Le
paramètre est le fichier objet hôte
entièrement qualifié de l'objet à lancer.

VRAI si l'objet est lancé avec succès.Valeur renvoyée

DescriptionParamètrePropriété

Chaîne<CHostData>.PhoneNumber(chaîne)

Bool<CHostData>.UseDialingProperties(Bool)

Entier<CHostData>.RedialCount(entier)

Entier<CHostData>.RedialDelay(entier)

Chaîne<CHostData>.Password(chaîne)

Définit lenuméro detéléphone del'ordinateur
hôte.

Définit les propriétés de numérotation du
système.

Définit lenombre detentatives derappel avant
l'annulation de l'appel.

Définit le nombre de secondes d'attente entre
les tentatives de rappel.

Définit le mot de passe sur l'objet hôte, à
utiliser avec les méthodes ExecuteProtection,
ReadProtection et WriteProtection.

Pour des raisons de sécurité, le serveur
d'automatisation pcAnywhere ne permet pas
de lire la valeur du mot de passe. Aucune
valeur de mot de passe n'est renvoyée.

Définitions d'objets Visual Basic

38

Propriétés CHostData

DescriptionParamètrePropriété

Bool<CHostData>.ExecuteProtection (Bool)

Bool<CHostData>.ReadProtection(Bool)

Bool<CHostData>.WriteProtection(Bool)

Chaîne<CHostData>.RecordFile(chaîne)

Bool<CHostData>.RecordSession(Bool)

Chaîne<CHostData>.ReadObject(chaîne)

Chaîne<CHostData>.WriteObject(chaîne)

Définit la nécessité d'un mot de passe pour
exécuter l'objet. Définir par mot de passe.

Définit l'obligation d'un mot de passe pour
afficher les propriétés de l'objet hôte. Définir
par mot de passe.

Définit l'obligation d'un mot de passe pour
enregistrer les modification de l'objet hôte.
Définir par mot de passe.

Active etdésactive laconsignation dessessionsBool<CHostData>.LogSession (Bool)

Définit le nom et le chemin d'accès
intégralement qualifié du fichier
d'enregistrement de la session active.

Active et désactive la consignation
automatique de session.

Définit le mot de passede l'objet. Vous pouvez
utiliser cette propriété pour actualiser la copie
locale des données de l'objet hôte.

Définit le mot de passe de l'objet. Utilisez cette
propriété pourcréer l'objethôte ou pour écrire
les changements apportés à celui-ci.

Propriété

Le tableau suivant décrit les propriétés et les valeurs renvoyées par CHostData.

Dans Tableau 2-18, remplacez les informations entre les chevrons par lesvaleurs
réelles.

Tableau 2-18

CHostData - Propriétés et valeurs renvoyées

DescriptionValeur

renvoyée

ChaîneString = <CHostData>.PhoneNumber

BoolBool = <CHostData>.UseDialingProperties

EntierInteger = <CHostData>.RedialCount

Renvoie lenuméro detéléphone del'ordinateur
hôte

Renvoie l'utilisation des propriétés de
numérotation dusystème définies dansl'objet
hôte.

Renvoie lenombre de tentativesd'appel défini
dans l'objet hôte.

Propriétés CHostData

39Définitions d'objets Visual Basic

Propriété

renvoyée

EntierInteger = <CHostData>.RedialDelay

BoolBool = <CHostData>.ExecuteProtection

BoolBool = <CHostData>.ReadProtection

BoolBool = <CHostData>.WriteProtection

ChaîneString = <CHostData>.RecordFile

BoolBool = <CHostData>.RecordSession

Propriétés du type de connexion

Le tableau suivant décrit les propriétés et les paramètres du type de connexion.

Dans Tableau 2-19, remplacez les informations entre les chevrons par lesvaleurs
réelles.

DescriptionValeur

Renvoie lenombre desecondes d'attenteentre
les tentatives de rappel.

Renvoie la valeur du paramètre
ExecuteProtection.

Renvoie la valeur du paramètre
ReadProtection.

Renvoie la valeur du paramètre
WriteProtection.

VRAI si la consignation de session est activée.BoolBool = <CHostData>.LogSession

Renvoie le nom et le chemin d'accès
intégralement qualifié du fichier
d'enregistrement de la session.

Renvoie la valeur du paramètre
d'enregistrement de session.

Définitions d'objets Visual Basic

40

Propriétés CHostData

Tableau 2-19

Type de connexion - Propriétés et paramètres

DescriptionParamètrePropriété

Chaîne<CHostData>.ConnectionType(chaîne)

Chaîne<CHostData>.AssignConnection(chaîne)

Chaîne<CHostData>.UnassignConnection(chaîne)

Définit letype deconnexion del'hôte. Lavaleur
transmise doit être un type de connexion
valide, défini par les fonctions
FirstConnectionType() et
NextConnectionType().

Les types suivants sont des exemples de
connexions valides :

■ COM1

■ COM2

■ COM3

■ COM4

■ TCP/IP

■ SPX

■ NetBIOS

■ RNIS via CAPI 2.0

■ Nom du modem (tel qu'il apparaît sur

l'ordinateur)

Définit le type de connexion présent dans la
chaîne sur l'état actif.

Définit le type de connexion présent dans la
chaîne sur l'état inactif.

Propriété

Le tableau suivant décrit les propriétés et les valeurs renvoyées pour le type de
connexion.

Dans Tableau 2-20, remplacez les informations entre les chevrons par lesvaleurs
réelles.

Tableau 2-20

Type de connexion - Propriétés et valeurs renvoyées

DescriptionValeur

renvoyée

Renvoie le type de connexion de l'objet hôte.ChaîneString = <CHostData>.ConnectionTypes

Propriétés CHostData

41Définitions d'objets Visual Basic

Propriété

renvoyée

EntierInteger = <CHostData>.ConnectionType

ChaîneString = <CHostData>.FirstConnectionType

ChaîneString = <CHostData>.NextConnectionType

DescriptionValeur

Renvoie le nombre de types de connexion
disponibles.

Les types suivants sont des exemples de
connexions valides :

■ COM1

■ COM2

■ COM3

■ COM4

■ TCP/IP

■ SPX

■ NetBIOS

■ RNIS via CAPI 2.0

■ Nom du modem (tel qu'il apparaît sur

l'ordinateur)

Renvoie le premier type de connexion
disponible.

Renvoie le type de connexion disponible
suivant. L'appel s'effectue de façon
séquentielle pour le nombre de types de
connexion défini dans
<CHostData>.ConnectionType, afin
d'énumérer tous les types de connexion.

connexion)

de connexion)

BoolBool =<CHostData>.FindConnectionType(type de

VRAI si le type de connexion indiqué a été
trouvé dans la liste des types de connexion
disponibles.

EntierInteger =<CHostData>.MaxAssignedConnections

Renvoie le nombre maximum de types de
connexion quipeuvent êtreactifs surcet hôte.

ChaîneString = <CHostData>.FirstAssignedConnection

Renvoie le premier type de connexion actif
affecté.

ChaîneString = <CHostData>.NextAssignedConnection

Renvoie le type de connexion actif affecté
suivant.

BoolBool =<CHostData>.FindAssignedConnection(type

VRAI si le type de connexion transmis
correspond à l'un des types de connexion
actifs.

Définitions d'objets Visual Basic

42

Propriétés CHostData

Méthode AssignConnection(type de connexion)

Cette méthode place le type de connexion requis dans la liste des types de
connexion affectés à l'objet Hôte et en fait le type de connexion en cours lors du
traitement ultérieur des appels de méthodes spécifiques au périphérique.

Si letype de connexion requis se trouve déjàdans la liste des connexions affectées,
celle-ci ne change pas. Seul le type de connexion actuel est remplacé par le type
demandé. Ilest normal d'appeler la méthode AssignConnection surle même objet
plusieurs fois lors de l'obtention et de la définition de valeurs propres à la
connexion.

AssignConnection renvoie VRAI si le type de connexion transmis existe sur
l'ordinateur et est affecté avec succès ou déjà affecté. Il renvoie FAUX si le type
de connexion requis n'existe pas sur l'ordinateur ou si le nombre de connexions
affectées a déjà atteint le maximum.

Un objethôte pcAnywherepeut prendreen chargejusqu'à deuxtypes deconnexion
affectés. Laméthode AssignConnection renvoie FAUX si elle détecte une tentative
de dépassement de cette limite.

Le tableau suivant définit le paramètre AssignConnection :

DescriptionParamètre

Nom d'un type de périphérique de connexion à affecter.Type deconnexion

comme chaîne

Le tableau suivant définit la valeur renvoyée pour AssignConnection :

DescriptionValeur renvoyée

Booléenne

VRAI si ce type de périphérique est disponible et si le nombre
maximum de connexions affectées n'a pas encore été atteint.

Méthode UnassignConnection (type de connexion)

Cette méthode renvoie VRAI si le type de connexion transmis a pu être retiré de
la liste des types de connexion affectés.

Le tableau suivant définit le paramètre UnassignConnection :

DescriptionParamètre

Nom d'un type de périphérique de connexion à désaffecter.Type deconnexion

comme chaîne

Le tableau suivant définit la valeur renvoyée pour UnassignConnection :

Propriétés de numérotation

Le tableau suivant décrit les propriétés et les valeurs renvoyées pour définir les
propriétés de numérotation pour les connexions par modem.

Dans Tableau 2-21, remplacez les informations entre les chevrons par lesvaleurs
réelles.

Propriétés CHostData

43Définitions d'objets Visual Basic

DescriptionValeur renvoyée

VRAI si ce type de périphérique est désaffecté avec succès.Booléenne

Propriété

Tableau 2-21

Propriétés de numérotation - Propriétés et paramètres

DescriptionParamètrePropriété

Chaîne<CHostData>.AreaCode(chaîne)

Chaîne<CHostData>.CountryCode(chaîne)

Définit le code de zone pour les connexions
par modem

Définit l'indicatif international pour les
connexions par modem

Le tableausuivant définit les propriétés et les valeursrenvoyées pourles propriétés
de numérotation par modem.

Dans Tableau 2-22, remplacez les informations entre les chevrons par lesvaleurs
réelles.

Tableau 2-22

Propriétés de numérotation par modem - Propriétés et valeurs
renvoyées

DescriptionValeur

renvoyée

Renvoie le code de zoneChaîneString = <CHostData>.AreaCode

Renvoie l'indicatif international.ChaîneString = <CHostData>.CountryCode

EntierInteger = <CHostData>.CountryCodes

Renvoie lenombre d'indicatifsinternationaux
disponibles.

ChaîneString= <CHostData>.FirstCountryCode

Renvoie le premier indicatif de pays
apparaissant dans la liste du système
d'exploitation.

Définitions d'objets Visual Basic

44

Propriétés CHostData

Propriété

renvoyée

ChaîneString = <CHostData>.NextCountryCode

Propriétés de périphérique COM

Le tableau suivant définit les propriétés et les paramètres qui vous permettent
de personnaliserles paramètres de port du modem etdes autresconnexions COM.

Dans Tableau 2-23, remplacez les informations entre les chevrons par lesvaleurs
réelles.

Tableau 2-23

Périphérique COM - Propriétés et paramètre

Chaîne<CHostData>.ComParity (chaîne)

DescriptionValeur

Renvoie l'indicatif international disponible
suivant. L'appel s'effectue de façon
séquentielle pour le nombre d'indicatifs
internationaux défini dans
<CHostData>.CountryCodes, afin d'énumérer
tous les indicatifs internationaux.

DescriptionParamètrePropriété

Définit la parité des communications.

Les valeurs suivantes sont valides :

■ <Aucune>

■ Impaire

■ Paire

■ Marque

■ Espace

Chaîne<CHostData>.ComFlowControl (chaîne)

Définit le contrôle de flux des types de
connexion COM.

Les valeurs suivantes sont valides :

■ <Aucune>

■ XONXOFF

■ RTS/CTS

■ Les deux

Propriétés CHostData

45Définitions d'objets Visual Basic

DescriptionParamètrePropriété

Chaîne<CHostData>.ComStartedBy(chaîne)

Définit le paramètre de début des types de
connexion COM.

Les valeurs suivantes sont valides :

■ Toujours connecté

■ Détection de porteuse (DCD)

■ Prêt à émettre (CTS)

■ Ensemble de données prêt (DSR)

■ Signal de sonnerie (RI)

■ Réception 2 <RC>

■ Réponse du modem

Chaîne<CHostData>.ComEndedBy(chaîne)

Définit le paramètre de fin des types de
connexion COM.

Les valeurs suivantes sont valides :

■ Toujours connecté

■ Détection de porteuse (DCD)

■ Prêt à émettre (CTS)

■ Ensemble de données prêt (DSR)

■ Signal de sonnerie (RI)

Long<CHostData>.ComSpeed(Long)

Définit la vitesse COM maximale

Les valeurs suivantes sont valides :

■ 110

■ 300

■ 600

■ 1200

■ 2400

■ 4800

■ 9600

■ 38400

■ 57600

■ 115200

Le tableausuivant décrit les propriétés et les valeursrenvoyées parle périphérique
COM.

Dans Tableau 2-24, remplacez les informations entre les chevrons par lesvaleurs
réelles.

Définitions d'objets Visual Basic

46

Propriétés CHostData

Propriété

Tableau 2-24

Périphériques COM - Propriétés et valeurs renvoyées

DescriptionValeur

renvoyée

ChaîneString = <CHostData>.ComParity

ChaîneString = <CHostData>.ComFlowControl

ChaîneString = <CHostData>.ComStartedBy

Renvoie l'une des valeurs suivantes comme
parité de communications :

■ <Aucune>

■ Impaire

■ Paire

■ Marque

■ Espace

Renvoie le paramètre de contrôle de flux de
l'objet hôte.

Les valeurs suivantes sont valides :

■ <Aucun>

■ XONXOFF

■ RTS/CTS

■ Les deux

Renvoie le contrôle de début des types de
connexion COM.

Les valeurs suivantes sont valides :

■ Toujours connecté

■ Détection de porteuse (DCD)

■ Prêt à émettre (CTS)

■ Ensemble de données prêt (DSR)

■ Signal de sonnerie (RI)

■ Réception 2 <RC>

■ Réponse du modem

ChaîneString = <CHostData>.ComEndedBy

Renvoie le contrôle de fin des types de
connexion COM

Les valeurs suivantes sont valides :

■ Toujours connecté

■ Détection de porteuse (DCD)

■ Prêt à émettre (CTS)

■ Ensemble de données prêt (DSR)

■ Signal de sonnerie (RI)

Propriétés CHostData

47Définitions d'objets Visual Basic

Propriété

renvoyée

LongLong = <CHostData>.ComSpeed

Propriétés de périphérique NetBIOS

Le tableausuivant définit les propriétés et les paramètres d'un périphériqueréseau
NetBIOS.

Dans Tableau 2-25, remplacez les informations entre les chevrons par lesvaleurs
réelles.

DescriptionValeur

Renvoie le paramètre de vitesse de
communication de l'objet hôte.

Les valeurs suivantes sont valides :

■ 110

■ 300

■ 600

■ 1200

■ 2400

■ 4800

■ 9600

■ 38400

■ 57600

■ 115200

Propriété

Tableau 2-25

NetBIOS - Propriétés et paramètres

DescriptionParamètrePropriété

Entier<CHostData>.LanaNumber(entier)

Définit lenuméro d'adaptateurréseau (LANA)
à utiliser pour les connexions NetBIOS.

Le tableau suivant définit les propriétés et les valeurs renvoyées pour un
périphérique réseau NetBIOS.

Dans Tableau 2-26, remplacez les informations entre les chevrons par lesvaleurs
réelles.

Tableau 2-26

Valeurs NetBIOS renvoyées

DescriptionValeur

renvoyée

EntierInteger = <CHostData>.LanaNumber

Renvoie le paramètre en cours du numéro
LANA pour les connexions NetBIOS.

Définitions d'objets Visual Basic

48

objet CHostDataEx

Propriétés de périphérique RNIS via CAPI 2.0

Le tableau suivant définit les propriétés et les paramètres pour les connexions
RNIS européennes.

Dans Tableau 2-27, remplacez les informations entre les chevrons par lesvaleurs
réelles.

Tableau 2-27

Le Tableau2-28 définit les propriétés et les valeursrenvoyées pourles connexions
RNIS européennes.

Tableau 2-28

Propriété

objet CHostDataEx

L'objet CHostDataEx contient la même fonctionnalité que l'objet CHostData avec
une fonctionnalité supplémentaire.

Le tableau suivant décrit les propriétés et les paramètres.

Dans Tableau 2-29, remplacez les informations entre les chevrons par lesvaleurs
réelles.

RNIS via CAPI 2.0 - Propriétés et paramètres

DescriptionParamètrePropriété

Bool<CHostData>.CapiChannelBonding(Bool)

Chaîne<CHostData>.CapiExtensions(chaîne)

Active ou désactive la liaison de canaux pour
les périphériques RNIS CAPI.

Définit toute extension CAPI supplémentaire
nécessaire pour les communications.

RNIS via CAPI 2.0 - Propriétés et valeurs renvoyées

DescriptionValeur

renvoyée

BoolBool= <CHostData>.CapiChannelBonding

ChaîneString = <CHostData>.CapiExtensions

Renvoie le paramètre de liaison de canaux
RNIS CAPI en cours dans l'objet hôte.

Renvoie la liste actuelle des extensions CAPI
à partir de l'objet hôte.

Tableau 2-29

CHostDataEx - Propriétés et paramètres

DescriptionParamètrePropriété

Chaîne<CHostData>.CryptPrivateKey (chaîne)

Définit le nom du conteneur de clé privée à
utiliser

objet CHostDataEx

49Définitions d'objets Visual Basic

DescriptionParamètrePropriété

Chaîne<CHostData>.CryptCommonName (chaîne)

Définit le nom commun de la clé privée à
utiliser.

Octet<CHostData>.CryptReqLevel(Octet)

Définit le niveau de chiffrement.

Les valeurs suivantes sont valides :

■ -1: Aucun

■ 0: pcAnywhere

■ 1: Symétrique

■ 2: Clé publique

Bool<CHostData>.CryptRefuseLower(Bool)

Définit si l'ordinateur hôte accepte une
connexion d'unordinateur distantutilisant un
niveau de chiffrement inférieur.

Chaîne<CHostData>.CallersPath(chaîne)

Définit le chemin d'accès intégralement
qualifié des fichiers d'appelant.

Bool<CHostData>.ConfirmConnect(Bool)

Définit siun messagedemandera àl'utilisateur
hôte de confirmer les connexions.

Octet<CHostData>.ConfirmTimeout(Octet)

Définit le nombre de secondes de délai pour
confirmer la connexion.

Bool<CHostData>.ConfirmDeny(Bool)

Définit sila connexiondoit seterminer lorsque
le délaide confirmationde laconnexion expire.

Bool<CHostData>.PwCaseSensitive(Bool)

Impose l'utilisationde motsde passesensibles
à la casse.

Octet<CHostData>.PwAttempts(Octet)

Définit le nombre d'échecs d'ouverture de
session consécutifs autorisés avant l'abandon
de la connexion.

Octet<CHostData>.PwTimeout(Octet)

Définit le nombre de minutes dont dispose
l'utilisateur pour ouvrir une session avant
l'abandon de la connexion.

Octet<CHostData>.ActiveKbds(Octet)

Définit quelle souris et quel clavier seront
actifs pendant la connexion.

Les valeurs suivantes sont valides :

■ 0: Hôte et distant

■ 1: Hôte

■ 2: Distant

Définitions d'objets Visual Basic

50

objet CHostDataEx

DescriptionParamètrePropriété

Octet<CHostData>.InactiveTimeout(Octet)

Définit le nombre de minutes pendant lequel
le clavier et la souris peuvent rester inactifs
avant l'abandon de la connexion.

Bool<CHostData>.LockSystemWhileWait(Bool)

Définit leverrouillage del'ordinateur hôte lors
du démarrage.

Bool<CHostData>.MinimizeOnLaunch(Bool)

Définit l'option de démarrage de l'hôte en
réduction.

Bool<CHostData>.RunAsService(Bool)

Active le fonctionnement de l'hôte comme
service.

Octet<CHostData>.ConnLostWait(Octet)

Définit le nombre de minutes d'attente avant
d'autoriser un autre appelant à se connecter.

Bool<CHostData>.ConnLostHostOpts(Bool)

Définit s'il faut attendre une autre connexion
ou annuler l'hôte si la session se termine de
façon anormale.

Les valeurs suivantes sont valides :

■ FAUX : Attente de la connexion suivante

■ VRAI : Annulation de l'hôte

Bool<CHostData>.EnableConnLostSecurity(Bool)

Active ou désactive les options de sécurité de
fin de session pour les sessions qui se
terminent de façon anormale.

objet CHostDataEx

51Définitions d'objets Visual Basic

DescriptionParamètrePropriété

Octet<CHostData>.AuthenticationType(octet)

Définit le type d'authentification.

Les valeurs suivantes sont valides :

■ 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: RSA SecurID

L'authentification pcAnywhereest utiliséepar
défaut siaucune valeurd'authentification n'est
définie ou si la valeur définie n'est pas valide
(par exemple,si letype d'authentificationn'est
pas disponible).

Octet<CHostData>.ConnLostSecurity(octet)

Définit lesoptions desécurité pour traiter une
fin de session anormale.

Les valeurs suivantes sont valides :

■ 1: Déconnecter l'utilisateur

■ 2: Redémarrer l'ordinateur hote

■ 3: Verrouiller l'ordinateur

Octet<CHostData>.CallbkDelay(octet)

Définit le nombre de secondes d'attente avant
que le modem hôte ne rappelle l'ordinateur
distant.

Bool<CHostData>.EndSessHostOpts(Bool)

Définit sil'hôte attendune autreconnexion ou
est annulé après la fin normale de la session.

Les valeurs suivantes sont valides :

■ FAUX : Attente de la connexion suivante

■ VRAI : Annulation de l'hôte

Bool<CHostData>.EnableEndSessSecurity(Bool)

Active oudésactive lesoptions desécurité pour
une fin de session normale.

Définitions d'objets Visual Basic

52

objet CHostDataEx

DescriptionParamètrePropriété

Octet<CHostData>.EndSessSecurity(octet)

Bool<CHostData>.BlankHost(Bool)

Bool<CHostData>.AllowRemoteMouse(Bool)

Bool<CHostData>.RebootOnDisconnect(Bool)

Bool<CHostData>.PasswordAfterDisc(Bool)

Bool<CHostData>.LogFailures(Bool)

Bool<CHostData>.AllowDriveSecurity(Bool)

Définit les options de sécurité pour une fin de
session normale.

Les valeurs suivantes sont valides :

■ 1: Déconnecter l'utilisateur

■ 2: Redémarrer l'ordinateur hote

■ 3: Verrouiller l'ordinateur

Définit l'effacement de l'écran de l'ordinateur
hôte. Certainescartes d'affichage neprennent
pas en charge cette fonction.

Désactive l'utilisation de la souris sur
l'ordinateur distant pendant une session.

Si VRAI,force l'ordinateur àredémarrer après
toute fin de session.

Déconnecte l'utilisateur lorsque la session se
termine.

Consigne les tentatives de mot de passe qui
ont échoué.

Active les options de sécurité de lecteur. Ce
paramètre n'estvalide quesur lessystèmes de
fichiers NTFS.

Propriété

Bool<CHostData>.UseDirectoryServices(Bool)

Active l'utilisationdes servicesd'annuaire pour
l'authentification.

Définit lesparamètres desservices d'annuaire.Chaîne<CHostData>.DirectoryServiceEntry(chaîne)

Le tableau suivant décrit les propriétés et les valeurs renvoyées pour l'objet
CHostDataEx.

Dans Tableau 2-30, remplacez les informations entre les chevrons par lesvaleurs
réelles.

Tableau 2-30

CHostDataEx - Propriétés et valeurs renvoyées

DescriptionValeur

renvoyée

ChaîneString = <CHostDataEx>.CryptPrivateKey

Renvoie le nom du conteneur de clé privée
actuellement actif.

objet CHostDataEx

53Définitions d'objets Visual Basic

Propriété

renvoyée

ChaîneString = <CHostDataEx>.CryptCommonName

OctetByte = <CHostDataEx>.CryptReqLevel

BoolBool = <CHostDataEx>.CryptRefuseLower

ChaîneString = <CHostDataEx>.CallersPath

BoolBool = <CHostDataEx>.ConfirmConnect

OctetByte = <CHostDataEx>.ConfirmTimeout

BoolBool = <CHostDataEx>.ConfirmDeny

DescriptionValeur

Renvoie le nom commun du conteneur de clé
privée actif.

Renvoie l'un des paramètres de chiffrement
suivants :

■ -1: Aucun

■ 0: pcAnywhere

■ 1: Symétrique

■ 2: Clé publique

Renvoie la valeur du paramètre de rejet de
niveau de chiffrement inférieur.

Renvoie le chemin d'accès intégralement
qualifié des fichiers d'appelant.

Renvoie la valeur du paramètre de
confirmation de connexion.

Renvoie la valeur du paramètre de rejet de
niveau de chiffrement inférieur.

Renvoie la valeur du paramètre de
déconnexion sur délai dépassé.

BoolBool = <CHostDataEx>.PwCaseSensitive

Renvoie la valeur du paramètre de mot de
passe sensible à la casse.

OctetByte = <CHostDataEx>.PwAttempts

Renvoie la valeur du paramètre de nombre
limite detentatives d'ouverture de session par
appel.

OctetByte = <CHostDataEx>.PwTimeout

Renvoie la valeur du paramètrede délai limite
d'ouverture de session (en minutes).

OctetByte = <CHostDataEx>.ActiveKbds

Renvoie les paramètres de clavier et de souris
actifs.

Les valeurs suivantes sont valides :

■ 0: Hôte et distant

■ 1: Hôte

■ 2: Distant

Définitions d'objets Visual Basic

54

objet CHostDataEx

Propriété

renvoyée

OctetByte = <CHostDataEx>. InactiveTimeout

BoolBool = <CHostDataEx>.LockSystemWhileWait

BoolBool = <CHostDataEx>.MinimizeOnLaunch

BoolBool = <CHostDataEx>.RunAsService

OctetByte = <CHostDataEx>.ConnLostWait

BoolBool = <CHostDataEx>.ConnLostHostOpts

BoolBool = <CHostDataEx>.ConnLostWait

DescriptionValeur

Renvoie le nombre de minutesd'attente avant
déconnexion si la limite d'inactivité est
atteinte.

Renvoie le paramètre de verrouillage de
l'ordinateur hôte au démarrage.

Renvoie le paramètre de démarrage de l'hôte
en réduction.

Renvoie le paramètre de fonctionnement de
l'hôte comme service.

Renvoie le nombre de minutesd'attente avant
d'autoriser un autre appelant à se connecter.

Renvoie le paramètre déterminant si l'hôte
attend une autre connexion ou s'arrête si la
session se termine de façon anormale.

Les valeurs suivantes sont valides :

■ FAUX : Attente de la connexion suivante

■ VRAI : Annulation de l'hôte

Renvoie lavaleur del'option desécurité définie
pour traiter une fin de session anormale.

objet CHostDataEx

55Définitions d'objets Visual Basic

Propriété

renvoyée

OctetByte = <CHostDataEx>.AuthenticationType

OctetByte = <CHostDataEx>.ConnLostSecurity

DescriptionValeur

Renvoie la référence de nombre du type
d'authentification.

Les valeurs suivantes sont valides :

■ 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: RSA SecurID

L'authentification pcAnywhereest utiliséepar
défaut siaucune valeurd'authentification n'est
définie ou si la valeur définie n'est pas valide
(par exemple,si letype d'authentificationn'est
pas disponible).

Renvoie la représentation numérique du
niveau de sécurité défini pour traiter une fin
de session anormale.

Les valeurs suivantes sont valides :

■ 1: Déconnecter l'utilisateur

■ 2: Redémarrer l'ordinateur hote

■ 3: Verrouiller l'ordinateur

OctetByte = <CHostDataEx>.CallbkDelay

Renvoie lenombre desecondes d'attenteavant
que le modem hôte ne rappelle l'ordinateur
distant.

BoolBool = <CHostDataEx>.EndSessHostOpts

Renvoie le paramètre déterminant si l'hôte
attend uneautre connexionou estannulé après
une fin de session normale.

Les valeurs suivantes sont valides :

■ FAUX : Attente de la connexion suivante

■ VRAI : Annulation de l'hôte

Définitions d'objets Visual Basic

56

objet CHostDataEx

Propriété

renvoyée

BoolBool = <CHostDataEx>.EnableEndSessSecurity

OctetByte = <CHostDataEx>.EndSessSecurity

BoolBool = <CHostDataEx>.BlankHost

BoolBool = <CHostDataEx>.AllowRemoteMouse

BoolBool = <CHostDataEx>.RebootOnDisconnect

BoolBool = <CHostDataEx>.PasswordAfterDisc

BoolBool = <CHostDataEx>.LogFailures

DescriptionValeur

Renvoie le paramètre déterminant si les
options de sécurité de fin de session sont
activées pour une fin de session normale.

Renvoie l'option de sécurité définie pour une
fin de session normale.

Les valeurs suivantes sont valides :

■ 1: Déconnecter l'utilisateur

■ 2: Redémarrer l'ordinateur hote

■ 3: Verrouiller l'ordinateur

Renvoie l'option définie pour l'effacement de
l'écran.

Renvoie l'option déterminant si l'utilisateur
distant dispose du contrôle du clavier et de la
souris au cours d'une session.

Renvoie l'option déterminant si l'ordinateur
hôte redémarre après la fin de la session.

Renvoie l'option déterminant si l'hôte est
déconnecté après la fin de la session.

Renvoie l'option déterminant si les échecs de
mots de passe sont consignés.

BoolBool = <CHostDataEx>.AllowDriveSecurity

BoolBool = <CHostDataEx>.UseDirectoryServices

Renvoie l'option déterminant si la sécurité du
lecteur est activée.

Renvoie l'option déterminant si les services
d'annuaire sont activés.

Renvoie lesparamètres deservices d'annuaire.ChaîneString = <CHostDataEx>.DirectoryServiceEntry

Exemple de code Visual Basic pour la fonctionnalité hôte.

L'exemple de code Visual Basic suivant récupère un objet de données hôte et
modifie ses propriétés.

Private Sub Command1_Click()

Dim HostDataManager as Object

Dim HostData as Object

Dim s as string

objet CHostDataEx

''créer un objet CHostDataManager

Set HostDataManager = CreateObject(WINAWSVR.BEHOSTDATAMANAGER)

''afficher et modifier le répertoire en cours

s = HostDataManager.CurrentDirectory()

MsgBox (s)

HostDataManager.ChangeDirectory ("C:\dev\bin.w32\data")

s = HostDataManager.CurrentDirectory()

MsgBox (s)

''récupérer un objet de données distant

Set HostData = HostDataManager.RetrieveObject("pod.BHF", 2, 0)

''afficher certaines propriétés

s = HostData.AreaCode()

MsgBox (s)

s = HostData.PhoneNumber()

MsgBox (s)

''définir certaines propriétés

RemoteData. HostData = "212"

RemoteData. HostData = "555-5555"

57Définitions d'objets Visual Basic

''écrire l'objet sur le disque

HostData.WriteObject (0)

End Sub

Utilisez les méthodes FindFirst et FindNext pour afficher le fichier d'hôte dans
un répertoire, comme suit :

Private Sub Command5_Click()

Dim HostDataManager as Object

Dim HostData as Object

Dim s as string

Set HostDataManager = CreateObject("WINAWSVR.BEHOSTDATAMANAGER")

Définitions d'objets Visual Basic

58

fonctions awrem32

HostDataManager.ChangeDirectory ("C:\dev\bin.w32\data")

HostDataManager.FindFirst "*", s

MsgBox (s)

HostDataManager.FindNext s

MsgBox (s)

End Sub

fonctions awrem32

Les fonctionsAwrem32 fournissentdes paramètres et renvoient des valeurs pour
la gestion des connexions entre l'ordinateur hôte et l'ordinateur distant.

fonction awrem32

awConnect(nom de fichier)

awConnect

awDisconnect()

FileXferFromHost(HostFile)

FileXferFromHost(RemoteFile)

FileXferFromHost

valeur
renvoyés

Paramètre =
Nom comme
chaîne

= booléen

Valeur renvoyée
= booléen

Paramètre =
HostFile comme
chaîne

Paramètre =
RemoteFile
comme chaîne

= booléen

DescriptionParamètre ou

Nom intégralementqualifié dufichier .chf
contenant les informations sur
l'ordinateur hôte.

VRAI si la commande est exécutée.Valeur renvoyée

Après avoir appelé cette fonction, le
programme appelant doit supprimer
l'objet (C++ -delete IAwrem32X*, VB – set
ObjectName = Nothing;)

Contient le chemind'accès intégralement
qualifié du fichier à copier à partir de
l'ordinateur hôte.

Contient lechemin d'accèsde destination,
intégralement qualifié. Les chaînes de
fichier hôte et de fichier distant ne sont
pas obligatoirement identiques.

VRAI si la commande est exécutée.Valeur renvoyée

fonctions awrem32

59Définitions d'objets Visual Basic

fonction awrem32

FileXferToHost(HostFile)

FileXferToHost(RemoteFile)

CreateFolderOnHost(nom
de répertoire)

CreateFolderOnHost

ExecuteHostFile(nom de
fichier)

valeur
renvoyés

Paramètre =
HostFile comme
chaîne

Paramètre =
RemoteFile
comme chaîne

Paramètre =
FolderName
comme chaîne

= booléen

Paramètre =
Nom de fichier
comme chaîne

DescriptionParamètre ou

Copie un fichier de l'ordinateur distant
vers l'ordinateur hôte. Les paramètres
peuvent contenir des caractères
génériques.

Le paramètre contient le chemin d'accès
de destination et le nom de fichier,
entièrement qualifiés.

Contient le chemind'accès intégralement
qualifié du fichier à copier à partir de
l'ordinateur distant.Les chaînesde fichier
hôte et de fichier distant ne sont pas
obligatoirement identiques.

Contient lelecteur etle chemind'accès du
dossier sur l'ordinateur hôte.

VRAI si la commande est exécutée.Valeur renvoyée

Exécute un fichier existant sur
l'ordinateur hôte. Cette fonction ne peut
exécuter que les fichiers batch, de
commandes etexécutables. Ellen'exécute
pas les fichiers associés aux exécutables.
Par exemple, cette fonction n'ouvre pas
Microsoft Wordsi vousexécutez unfichier
.doc.

Le paramètre contient le chemin d'accès
intégralement qualifié du fichier sur
l'ordinateur hôte.

ExecuteHostFile

GetError()

= booléen

Valeur renvoyée
= Chaîne

VRAI si la commande est exécutée.Valeur renvoyée

Renvoie la dernière erreur générée dans
Awrem32.

Définitions d'objets Visual Basic

60

fonctions awrem32

fonction awrem32

ConnectionStatus()

valeur
renvoyés

Valeur retournée
= Court

DescriptionParamètre ou

Renvoie l'état courant de la connexion à
l'ordinateur hôte.

Les valeurs possibles sont les suivantes :

■ -1 = Connexion perdue

■ 0 = Aucune connexion

■ 1 = Session connectée

Chapitre

Définitions d'objets Visual C++

Ce chapitre traite des sujets suivants :

■ A propos des objets Visual C++

■ Méthodes CRemoteDataManager

■ objet CRemoteData

■ objet CRemoteDataEx

3

■ Méthodes CHostDataManager

■ objet CHostData

■ objet CHostDataEx

■ fonctions awrem32

A propos des objets Visual C++

Le serveur d'automatisation pcAnywhere offre les composants suivants pour la
prise en charge de l'automatisation OLE :

Winawsvr

Awrem32

Les objets décrits dans le Tableau 3-1 composent Winawsvr.

Contient lesinformations nécessairespour seconnecter au serveur
d'automatisation pcAnywhere et accéder à ses interfaces.

Contient lesinformations nécessaires aucontrôle desconnexions
pcAnywhere.

Définitions d'objets Visual C++

62

Méthodes CRemoteDataManager

CRemoteDataManager

CRemoteData

CHostDataManager

CHostData

Tableau 3-1

Objets Winawsvr

RéférenceDescriptionObjet

Fournit les méthodes pour créer, ouvrir,
modifier, enregistrer et supprimer les
objets CRemoteData.

Définit les paramètres permettant
d'accéder à la fonction distant de
pcAnywhere et de la contrôler.

Fournit les méthodes pour créer, ouvrir,
modifier, enregistrer et supprimer les
objets ChostData.

Définit les paramètres permettant
d'accéder àla fonctionhôte depcAnywhere
et de la contrôler.

Se reporter à "Méthodes

CRemoteDataManager" à la page 62.

Se reporter à "objet CRemoteData"
à la page 66.

Se reporter à "objet CRemoteDataEx"
à la page 72.

Se reporter à "Méthodes

CHostDataManager" à la page 73.

Se reporter à "objet CRemoteData"
à la page 66.

Se reporter à "objet CRemoteDataEx"
à la page 72.

Awrem32 possède un objet, constitué de huit interfaces, pour prendre en charge
les sessions de téléintervention et de transfert de fichiers.

Se reporter à "fonctions awrem32" à la page 88.

Quelques fonctions ne sont plus prises en charge. Cependant, les définitions
d'objets sont utilisables avec les versions précédentes.

Pour les fonctions nécessitant des mots de passe, les valeurs des mots de passe
peuvent être définies mais non récupérées, pour des raisons de sécurité.

Méthodes CRemoteDataManager

Les méthodes CRemoteDataManager fournissent les paramètres et renvoient les
valeurs permettant d'accéder aux objets CRemoteData et de les contrôler.

Méthode

valeur renvoyés

BSTR CurrentDirectory();

Paramètre =
BSTR

DescriptionParamètre ou

Nom complet de chemin d'accès au
dossier dedonnées pcAnywhereen cours
dans lequel les objets distants sont
enregistrés.

Méthodes CRemoteDataManager

63Définitions d'objets Visual C++

Méthode

BOOL
ChangeDirectory(LPCTSTR
lpszNewDirectory);

BOOL FindFirst(LPCTSTR
lpszPattern, BSTR FAR* );

BOOL
FindFirst(pbstrFullQualName);

BOOL FindFirst

BOOL FindNext(BSTR FAR*
pbstrFullQualName);

valeur renvoyés

Paramètre =
LPCTSTR
lpszNewDirectory

Valeur renvoyée
= booléen

Paramètre =
LPCTSTR
lpszPattern

Parameter =
BSTR FAR *
pbstrFullQualName

Valeur renvoyée
= booléen

Parameter =
BSTR FAR *
pbstrFullQualName

Valeur renvoyée
= booléen

DescriptionParamètre ou

Change le dossier actuel dans lequel les
objets distantspcAnywhere sontstockés.
Le paramètre est le nom d'un dossier
existant.

La valeur retournée est VRAIE en cas de
succès.

Schéma de nom de fichier pour filtrer
les fichiers d'objet (un astérisque [*]
trouve tousles fichiersdans lerépertoire
en cours).

Tampon deretour pourle chemin d'accès
complet du fichier d'objet distant
correspondant au schéma spécifié.

VRAI si un fichier d'objet distant
correspondant au schéma spécifié est
trouvé. Le chemin d'accès complet du
fichier est stocké dans
pbstrFullQualName.

Après l'appel réussi de FindFirst() pour
obtenir le nom d'un fichier d'objet
distant dans le dossier en cours,
FindNext() peutêtre appelépour trouver
le fichier suivant correspondant au
schéma.

Renvoie la valeur VRAI si un autre
fichier d'objet distant correspondant au
schéma spécifié dans l'appel de
FindFirst() esttrouvé. Lechemin d'accès
complet du fichier est stocké dans
pbstrFullQualName.

LPDISPATCH
RetrieveObject(LPCTSTR
lpszFQName);

Parameter =
LPCTSTR
lpszFQName

Récupère unobjet CRemoteData parnom
de fichier.

Le paramètre est le nom intégralement
qualifié du fichier d'objet distant à
charger.

Définitions d'objets Visual C++

64

Méthodes CRemoteDataManager

Méthode

LPDISPATCH
RetrieveObject(short
wAccessMode);

LPDISPATCH
RetrieveObject(LPCTSTR
lpszPassword);

LPDISPATCH
RetrieveObjectEx(LPCTSTR
lpszFQName);

LPDISPATCH
RetrieveObjectEx(short
wAccessMode);

valeur renvoyés

Parameter =
short
wAccessMode

LPCTSTR
lpszPassword

Parameter =
LPCTSTR
lpszFQName

Parameter =
short
wAccessMode

DescriptionParamètre ou

Spécifie comment cet objet doit être
utilisé. Ce paramètre est lié à la
protection parmot de passe.Les options
sont les suivantes :

■ 0 = Non spécifié

■ 1 = Afficher uniquement

■ 2 = Afficher et modifier

■ 3 = Exécuter

Mot de passe de l'objet. Peut être NULL.Parameter =

Récupère un objet CRemoteDataEx par
nom de fichier.

Le paramètre est le nom intégralement
qualifié du fichier d'objet distant à
charger.

Spécifie comment cet objet doit être
utilisé. Ce paramètre est lié à la
protection parmot de passe.Les options
sont les suivantes :

■ 0 = Non spécifié

■ 1 = Afficher uniquement

■ 2 = Afficher et modifier

■ 3 = Exécuter

LPDISPATCH
RetrieveObjectEx(LPCTSTR
lpszPassword);

LPDISPATCH
RetrieveObjectEx

LPCTSTR
lpszPassword

Valeur renvoyée
= LPDISPATCH

Mot de passe de l'objet. Peut être NULL.Parameter =

Pointeur sur un objet envoi OLE. L'objet
est un objet CRemoteDataEx.

Voir Exemple de code Visual C++ pour

la fonctionnalité du distant.

Méthodes CRemoteDataManager

65Définitions d'objets Visual C++

Méthode

LPDISPATCH
CreateObject(LPCTSTR
lpszFQName);

LPDISPATCH
CreateObjectEx(LPCTSTR
lpszFQName);

valeur renvoyés

Parameter =
LPCTSTR
lpszFQName

Valeur renvoyée
= LPDISPATCH

Parameter =
LPCTSTR
lpszFQName

Valeur renvoyée
= LPDISPATCH

DescriptionParamètre ou

Crée un objet CRemoteData et renvoie
un pointeurLPDISPATCH quile désigne.

Le paramètre est le nom de fichier
entièrement qualifiéd'objet distantpour
le nouvel objet.

La valeur renvoyée est un pointeur vers
un objet envoi OLE. L'objet est un objet
CRemoteData.

Voir Exemple de code Visual C++ pour

la fonctionnalité du distant.

Crée unobjet CRemoteDataExet renvoie
un pointeurLPDISPATCH quile désigne.

Le paramètre est le nom de fichier
entièrement qualifiéd'objet distantpour
le nouvel objet.

La valeur renvoyée est un pointeur vers
un objet envoi OLE. L'objet est un objet
CRemoteDataEx.

Voir Exemple de code Visual C++ pour

la fonctionnalité du distant.

BOOL DeleteObject(LPCTSTR
lpszFQName);

BOOL DeleteObject(LPCTSTR
lpszPassword);

BOOL Launch(LPCTSTR
lpszFQName);

Parameter =
LPCTSTR
lpszFQName

LPCTSTR
lpszPassword

Parameter =
LPCTSTR
lpszFQName

Valeur renvoyée
= booléen

Supprime un fichier d'objet distant.

Le paramètre est le nom intégralement
qualifié du fichier d'objet distant de
l'objet à supprimer.

Mot de passe de l'objet. Peut être NULL.Parameter =

VRAI si l'objet est supprimé.BOOLBOOL DeleteObject

Lance un fichier d'objet distant, ce qui
ouvre la fenêtre de terminal distant
pcAnywhere.

Le paramètreest lefichier intégralement
qualifié d'objetdistant de l'objet à lancer.

La valeurrenvoyée estVRAI si l'objet est
lancé avec succès.

Définitions d'objets Visual C++

66

objet CRemoteData

objet CRemoteData

Utilisez cet objet pour modifier les données d'objet distant.

Méthodes Get et Set (obtenir et définir)

Les méthodes suivantes servent à obtenir (Get) et définir (Set) les propriétés de
l'objet CRemoteData.

Le nom de l'ordinateur est le nom de système de l'hôte pcAnywhere à appeler
lorsque l'objet distant est lancé.

BSTR GetComputerName();

void SetComputerName(LPCTSTR lpszNewValue);

Le numérode téléphone est le numéro à composer pour établirune connexionpar
modem avec un ordinateur hôte pcAnywhere.

BSTR GetPhoneNumber();

void SetPhoneNumber(LPCTSTR lpszNewValue);

Indique sides propriétésde numérotation TAPI doivent être utilisées (informations
d'emplacement) (VRAI) ou si la chaîne du numéro de téléphone doit être utilisée
exactement telle qu'elle apparaît (FAUX).

BOOL GetUseDialingProperties();

void SetUseDialingProperties(BOOL bNewValue);

Si lespropriétés de numérotation sont utilisées, il s'agitdu codede zone du numéro
à appeler.

BSTR GetAreaCode();

void SetAreaCode(LPCTSTR lpszNewValue);

Si les propriétés de numérotation sont utilisées,il s'agit de l'indicatif international
du numéro à appeler.

BSTR GetCountryCode();

void SetCountryCode(LPCTSTR lpszNewValue);

Nombre de tentatives d'appel de ce numéro si l'appel échoue.

short GetRedialCount();

void SetRedialCount(short nNewValue);

Délai en secondes entre les tentatives d'appel.

objet CRemoteData

short GetRedialDelay();

void SetRedialDelay(short nNewValue);

Nom d'utilisateurà envoyerà l'hôte lorsqu'une connexion est établie. Si ce champ
reste vide, l'utilisateur doit fournir un nom à la connexion.

BSTR GetAutoLoginName();

void SetAutoLoginName(LPCTSTR lpszNewValue);

Mot de passe de session envoyé à l'hôte lorsqu'une connexion est établie. Si ce
champ reste vide, l'utilisateur doit fournir un mot de passe lors de la connexion.

BSTR GetAutoLoginPassword();

void SetAutoLoginPassword(LPCTSTR lpszNewValue);

Mot de passe de cet objet.

BSTR GetPassword();

void SetPassword(LPCTSTR lpszNewValue);

L'objet ne peut être lancé que si le mot de passe est utilisé (VRAI).

BOOL GetExecuteProtection();

void SetExecuteProtection(BOOL bNewValue);

67Définitions d'objets Visual C++

L'objet ne peut être affiché que si le mot de passe correct est fourni (VRAI).

BOOL GetReadProtection();

void SetReadProtection(BOOL bNewValue);

L'objet ne peut être écrit que si le mot de passe correct est fourni (VRAI).

BOOL GetWriteProtection();

void SetWriteProtection(BOOL bNewValue);

Contrôle si les sessions utilisant cet objet sont consignées.

BOOL GetLogSession();

void SetLogSession(BOOL bNewValue);

Contrôle si les sessions utilisant cet objet sont enregistrées depuis le début.

BOOL GetRecordSession();

void SetRecordSession(BOOL bNewValue);

Nom du fichier d'enregistrement pour les sessions utilisant cet objet.

BSTR GetRecordFile();

void SetRecordFile(LPCTSTR lpszNewValue);

Définitions d'objets Visual C++

68

objet CRemoteData

Définit les types de connexion.

BOOL GetRunOnConnect();

void SetRunOnConnect(BOOL bNewValue);

Les types de connexion suivants sont disponibles :

■ COM1

■ COM2

■ COM3

■ COM4

■ RNIS via CAPI 2.0

■ NetBIOS

■ SPX

■ DEFAULT TAPI

■ TCP/IP

Le nom d'un périphérique TAPI peut également servir de type de connexion.
DEFAULT TAPIutilise le premier périphérique TAPItrouvé dansle système. Pour
utiliser un périphérique TAPI spécifique, utilisez FirstConnectionType() /
NextConnectionType() pour rechercher les périphériques disponibles.

Méthodes de détail d'objet distant

Lorsqu'un type de connexion est affecté à un objet distant, les détails du
périphérique sont définis sur les valeurs par défaut valides.

Les typesde connexionsuivants possèdent des options de configuration avancées
qui peuvent être définies dans l'application :

■ Périphériques COM

■ Périphériques NetBIOS

■ Périphériques RNIS via CAPI 2.0 (RNIS européen seulement)

Détails de périphérique COM

Définit la parité des communications.

BSTR GetComParity();

void SetComParity(LPCTSTR lpszNewValue);

Les valeurs de parité de communication sont les suivantes :

■ Aucune

■ Impaire

■ Paire

■ Marque

■ Espace

Définit le niveau de contrôle de flux.

BSTR GetComFlowControl();

void SetComFlowControl(LPCTSTR lpszNewValue);

Les valeurs de contrôle de flux sont les suivantes :

■ <Aucun>

■ XONXOFF

■ RTS/CTS

■ LES DEUX

Définit le paramètre de début de connexion.

objet CRemoteData

69Définitions d'objets Visual C++

BSTR GetComStartedBy();

void SetComStartedBy(LPCTSTR lpszNewValue);

Les valeurs de début de connexion sont les suivantes :

■ Toujours connecté

■ Détection de porteuse (DCD)

■ Prêt à émettre (CTS)

■ Ensemble de données prêt (DSR)

■ Signal de sonnerie (RI)

■ Réception 2 <CR>

■ Réponse du modem

Définit les valeurs de fin de connexion.

BSTR GetComEndedBy();

void SetComEndedBy(LPCTSTR lpszNewValue);

Les valeurs de fin de connexion sont les suivantes :

■ Toujours connecté

■ Détection de porteuse (DCD)

Définitions d'objets Visual C++

70

objet CRemoteData

■ Prêt à émettre (CTS)

■ Ensemble de données prêt (DSR)

■ Signal de sonnerie (RI)

Définit la vitesse de connexion.

long GetComSpeed();

void SetComSpeed(long nNewValue);

Les valeurs de vitesse de connexion sont les suivantes :

■ 110

■ 300

■ 600

■ 1200

■ 2400

■ 4800

■ 9600

■ 19200

■ 38400

■ 57600

■ 115200

Détails de périphérique NetBios

Définit le numéro de LANA (adaptateur réseau) à utiliser pour cette connexion.

short GetLanaNumber();

void SetLanaNumber(short nNewValue);

Détails de périphérique RNIS via CAPI2.0

Active laliaison de canaux (utilise deux canaux RNIS pour uneconnexion) siVRAI.

BOOL GetCapiChannelBonding();

void SetCapiChannelBonding(BOOL bNewValue);

Définit touteextension CAPIsupplémentaire nécessairepour les communications.

BSTR GetCapiExtensions();

void SetCapiExtensions(LPCTSTR lpszNewValue);

Méthodes d'objet distant

Les tableaux suivants décrivent les méthodes normales de l'objet distant (elles ne
servent pas à obtenir et à définir les propriétés de l'objet).

objet CRemoteData

71Définitions d'objets Visual C++

Méthode

short ConnectionTypes();

BSTR
FirstConnectionType(); et
BSTR
NextConnectionType();

BOOL
FindConnectionType(LPCTSTR
lpszConnectionType);

short CountryCodes();

valeur renvoyés

Valeur retournée
= Court

Valeur renvoyée =
BSTR

Paramètre =
LPCTSTR
lpszConnectionTyp

Valeur renvoyée =
booléen

Valeur retournée
= Court

DescriptionParamètre ou

Nombre de types de connexion
disponibles sur cet ordinateur

FirstConnectionType() et
NextConnectionType() servent à itérer
parmi les types de connexion
disponibles. Ces fonctions renvoient un
BSTR qui est le nom d'un type de
connexion disponible. Les types de
connexion renvoyéspeuvent êtreutilisés
avec la fonction SetConnectionType().

La valeur renvoyée est le nom d'un type
de périphérique de connexion pris en
charge.

Nom d'un type de périphérique de
connexion.

La valeurrenvoyée estVRAI si le type de
connexion transmis existe sur
l'ordinateur.

Renvoie le nombre d'indicatifs
internationaux disponibles.

BSTR FirstCountryCode();et
BSTR NextCountryCode();

Valeur renvoyée =
BSTR

FirstCountryCode() etNextCountryCode()
servent à circuler parmi les indicatifs
internationaux disponibles. Ces
fonctions renvoient un BSTR qui est le
nom d'un indicatif international
disponible. Les valeurs renvoyées
peuvent être utilisées avec la fonction
SetCountryCode().

La valeur renvoyée est la première
chaîne d'indicatifinternational ouchaîne
suivante.

Définitions d'objets Visual C++

72

objet CRemoteDataEx

Méthode

BOOL ReadObject(LPCTSTR
lpszPassword);

BOOL WriteObject(LPCTSTR
lpszPassword);

objet CRemoteDataEx

L'objet CRemoteDataEx contient la même fonction quel'objet CRemoteData, avec
les méthodes supplémentaires Get et Set (obtenir et définir) suivantes :

BSTR GetPrivateKey(); //Renvoie les informations de PrivateKey

void SetPrivateKey(LPCTSTR lpszNewValue);

BSTR GetCertificationName(); //Renvoie le nom de certificat

void SetCertificationName(LPCTSTR lpszNewValue);

short GetEncryptionLevel(); //Renvoie la valeur du niveau de chiffrement

void SetEncryptionLevel(short nNewValue);

BOOL GetDenyLowerEncrypt(); //Renvoie la valeur DenyLowerEncrypt

void SetDenyLowerEncrypt(BOOL bNewValue);

BSTR GetAutoDomain(); //Renvoie la valeur AutoDomain

void SetAutoDomain(LPCTSTR lpszNewValue);

valeur renvoyés

Paramètre =
LPCTSTR
lpszPassword

Valeur renvoyée =
booléen

Paramètre =
LPCTSTR
lpszPassword

Valeur renvoyée =
booléen

DescriptionParamètre ou

Lit les données d'objet du fichier d'objet
distant.

Le paramètre est le mot de passe objet

La valeurrenvoyée est VRAI si l'objet est
lancé avec succès.

Ecrit les données d'objet dans le fichier
d'objet distant.

Le paramètre est le mot de passe objet

La valeurrenvoyée est VRAI si l'objet est
lancé avec succès.

Exemple de code Visual C++ pour la fonctionnalité du distant

L'exemple suivant de fonction C++ crée un objet distant, définit son type de
connexion surTCP/IP, définitle nomde l'ordinateur sur l'adresse TCP/IP transmise
dans la fonction, puis lance l'objet distant.

BOOL LaunchTCPRemote(LPCTSTR lpszAddress)

{

BOOL bReturn = FALSE;

Méthodes CHostDataManager

CRemoteDataManager remoteDM;

CRemoteData remoteData;

// Créer d'abord le CRemoteDataManager

remoteDM.CreateDispatch( _T( "WINAWSVR.RemoteDataManager") );

// Créer ensuite CRemoteData et le rattacher

remoteData.AttachDispatch( remoteDM.CreateObject("Test", 0) );

// Définir à présent les propriétés requises

remoteData.SetConnectionType("TCP/IP");

remoteData.SetComputerName(lpszAddress);

// Enregistrer les données de l'objet

if (remoteData.WriteObject(0))

{

// Et le lancer

if (remoteData.Launch())

bReturn = TRUE;

}

// Libérer l'objet distant.

remoteData.ReleaseDispatch();

73Définitions d'objets Visual C++

remoteDM.ReleaseDispatch( _T( "WINAWSVR.RemoteDataManager") );

return bReturn;

}

Méthodes CHostDataManager

Le tablesuivant décritles méthodes CHostDataManager, y compris les paramètres
et les valeurs renvoyées pour accéder aux objets CHostData et les contrôler :

Définitions d'objets Visual C++

74

Méthodes CHostDataManager

Méthode

BSTR CurrentDirectory();

BOOL
ChangeDirectory(LPCTSTR
lpszNewDirectory);

BOOL FindFirst(LPCTSTR
lpszPattern);

valeur renvoyés

Valeur renvoyée =
BSTR

Paramètre =
LPCTSTR
lpszNewDirectory

Valeur renvoyée =
booléen

Paramètre =
LPCTSTR
lpszPattern

Valeur renvoyée =
booléen

DescriptionParamètre ou

Renvoie le chemin d'accès complet du
répertoire en cours dans lequel les
objets hôtede pcAnywheresont stockés.

Change le dossier en cours dans lequel
les objets hôte de pcAnywhere sont
stockés.

Le paramètre est le nom d'un dossier
existant.

La valeur renvoyée est VRAI en cas de
succès.

Trouve le premier fichier d'objet hôte
pcAnywhere (*.bhf) dans le dossier en
cours, sur la base du schéma du nom de
fichier spécifié.

Le paramètre est le schéma de nom de
fichier pour filtrer les fichiers d'objet
(un astérisque[*] trouvetous lesfichiers
hôte dans le répertoire en cours).

La valeur renvoyée est VRAI si un
fichier d'objet hôte correspondant au
schéma spécifié est trouvé. Le chemin
d'accès complet du fichier est stocké
dans pbstrFullQualName.

BOOL FindFirst(BSTR
FAR* pbstrFullQualName);

Parameter = BSTR
FAR *
pbstrFullQualName

Tampon de retour pour le chemin
d'accès complet du fichier d'objet
distant correspondant au schéma
spécifié.

La valeur renvoyée est VRAI si un
fichier d'objet hôte correspondant au
schéma spécifié est trouvé. Le chemin
d'accès complet du fichier est stocké
dans pbstrFullQualName.

Méthodes CHostDataManager

75Définitions d'objets Visual C++

Méthode

BOOL FindNext(BSTR
FAR* pbstrFullQualName);

LPDISPATCH
RetrieveObject(LPCTSTR
lpszFQName);

LPDISPATCH
RetrieveObject(short
wAccessMode);

valeur renvoyés

Parameter = BSTR
FAR *
pbstrFullQualName

Valeur renvoyée =
booléen

Parameter =
LPCTSTR
lpszFQName

Parameter = short
wAccessMode

DescriptionParamètre ou

Après l'appel réussi de FindFirst() pour
obtenir le nom d'un fichier d'objet hôte
dans ledossier encours, FindNext()peut
être appelé pour trouver le fichier
suivant correspondant au schéma.

Le paramètr est le tampon de retour
pour le chemin d'accès complet du
fichier d'objetdistant correspondantau
schéma spécifié dans l'appel initial de
FindFirst().

Renvoie la valeur VRAI si un autre
fichier d'objetdistant correspondantau
schéma spécifié dans l'appel de
FindFirst() esttrouvé. Lechemin d'accès
complet du fichier est stocké dans
pbstrFullQualName.

Récupère un objet CHostData par nom
de fichier.

Le paramètre est le nom intégralement
qualifié dufichier d'objethôte àcharger.

Spécifie comment cet objet doit être
utilisé. Ce paramètre est lié à la
protection parmot depasse. Lesoptions
sont les suivantes :

■ 0 = Non spécifié

■ 1 = Afficher uniquement

■ 2 = Afficher et modifier

■ 3 = Exécuter

LPDISPATCH
RetrieveObject(LPCTSTR
lpszPassword);

LPDISPATCH
RetrieveObject

LPCTSTR
lpszPassword

Valeur renvoyée =
LPDISPATCH

Mot de passe de l'objet.Peut être NULL.Parameter =

Pointeur surun objetenvoi OLE. L'objet
est un objet CHostData.

Voir Exemple de code Visual C++ pour

la fonctionnalité Hôte.

Définitions d'objets Visual C++

76

Méthodes CHostDataManager

Méthode

LPDISPATCH
RetrieveObjectEx(LPCTSTR
lpszFQName);

LPDISPATCH
RetrieveObjectEx(short
wAccessMode);

LPDISPATCH
RetrieveObjectEx(LPCTSTR
lpszPassword);

LPDISPATCH
RetrieveObjectEx

valeur renvoyés

Parameter =
LPCTSTR
lpszFQName

Parameter = short
wAccessMode

LPCTSTR
lpszPassword

Valeur renvoyée =
LPDISPATCH

DescriptionParamètre ou

Récupère un objet CHostDataEx par
nom de fichier.

Le paramètre est le nom intégralement
qualifié dufichier d'objethôte àcharger.

Spécifie comment cet objet doit être
utilisé. Ce paramètre est lié à la
protection parmot depasse. Lesoptions
sont les suivantes :

■ 0 = Non spécifié

■ 1 = Afficher uniquement

■ 2 = Afficher et modifier

■ 3 = Exécuter

Mot de passe de l'objet.Peut être NULL.Parameter =

Pointeur surun objetenvoi OLE. L'objet
est un objet CHostDataEx.

Voir Exemple de code Visual C++ pour

la fonctionnalité Hôte.

LPDISPATCH
CreateObject(LPCTSTR
lpszName);

Parameter =
LPCTSTR
lpszFQName

Valeur renvoyée =
LPDISPATCH

Crée un objet CHostData et renvoie un
pointeur LPDISPATCH qui le désigne.

Le paramètre est le nom de fichier
entièrement qualifiéd'objet distantpour
le nouvel objet.

La valeurrenvoyée estun pointeurvers
un objet envoi OLE. L'objet est un objet
CHostData.

Voir Exemple de code Visual C++ pour

la fonctionnalité Hôte.

objet CHostData

77Définitions d'objets Visual C++

Méthode

LPDISPATCH
CreateObjectEx(LPCTSTR
lpszName);

BOOL
DeleteObject(LPCTSTR
lpszFQName);

BOOL
DeleteObject(LPCTSTR
lpszPassword);

BOOL DeleteObject

valeur renvoyés

Parameter =
LPCTSTR
lpszFQName

Valeur renvoyée =
LPDISPATCH

Parameter =
LPCTSTR
lpszFQName

LPCTSTR
lpszPassword

booléen

DescriptionParamètre ou

Crée un objet CHostDataEx et renvoie
un pointeurLPDISPATCH quile désigne.

Le paramètre est le nom de fichier
entièrement qualifiéd'objet distantpour
le nouvel objet.

La valeurrenvoyée estun pointeurvers
un objet envoi OLE. L'objet est un objet
CHostDataEx.

Voir Exemple de code Visual C++ pour

la fonctionnalité Hôte.

Supprime un fichier d'objet hôte.

Le paramètre est le fichier objet hôte
entièrement qualifié de l'objet à
supprimer.

Mot de passe de l'objet.Peut être NULL.Parameter =

VRAI si l'objet est supprimé.Valeur renvoyée =

BOOL Launch(LPCTSTR
lpszFQName);

Parameter =
LPCTSTR
lpszFQName

Valeur renvoyée =
booléen

objet CHostData

Utilisez cet objet pour modifier les données de l'objet hôte.

Méthodes Get et Set (obtenir et définir)

Les méthodes suivantes servent à obtenir (Get) et définir (Set) les propriétés de
l'objet CHostData.

Lance un fichier d'objet hôte, ce qui
ouvre la fenêtre de terminal de l'hôte
pcAnywhere.

Le paramètre est le fichier objet hôte
entièrement qualifié de l'objet à lancer.

La valeur renvoyée est VRAI si l'objet
est lancé avec succès.

Définitions d'objets Visual C++

78

objet CHostData

Le numérode téléphone est le numéro à composer pour établirune connexionpar
modem avec un ordinateur distant pcAnywhere.

BSTR GetPhoneNumber();

void SetPhoneNumber(LPCTSTR lpszNewValue);

Indique sides propriétésde numérotation TAPI doivent être utilisées (informations
d'emplacement) (VRAI) ou si la chaîne du numéro de téléphone doit être utilisée
exactement telle qu'elle apparaît (FAUX).

BOOL GetUseDialingProperties();

void SetUseDialingProperties(BOOL bNewValue);

Si lespropriétés de numérotation sont utilisées, il s'agitdu codede zone du numéro
à appeler.

BSTR GetAreaCode();

void SetAreaCode(LPCTSTR lpszNewValue);

Si les propriétés de numérotation sont utilisées,il s'agit de l'indicatif international
du numéro à appeler.

BSTR GetCountryCode();

void SetCountryCode(LPCTSTR lpszNewValue);

Nombre de tentatives d'appel de ce numéro si l'appel échoue.

short GetRedialCount();

void SetRedialCount(short nNewValue);

Délai en secondes entre les tentatives d'appel.

short GetRedialDelay();

void SetRedialDelay(short nNewValue);

Contrôle si les sessions utilisant cet objet sont consignées.

BOOL GetLogSession();

void SetLogSession(BOOL bNewValue);

Contrôle si les sessions utilisant cet objet sont enregistrées depuis le début.

BOOL GetRecordSession();

void SetRecordSession(BOOL bNewValue);

Nom du fichier d'enregistrement pour les sessions utilisant cet objet.

BSTR GetRecordFile();

void SetRecordFile(LPCTSTR lpszNewValue);

Méthodes de détail d'objet hôte

Lorsqu'un typede connexion est affecté à un objethôte, lesdétails du périphérique
sont définis sur des valeurs par défaut valides.

Les typesde connexionsuivants possèdent des options de configuration avancées
qui peuvent être définies dans l'application :

■ Périphériques COM

■ Périphériques NetBIOS

■ Périphériques NASI/NCSI

■ Périphériques RNIS via CAPI 2.0 (RNIS européen seulement)

Détails de périphérique COM

Le code suivant place le type de connexion requis dans la liste des types de
connexion affectés à l'objet hôte et en fait le type de connexion en cours lors du
traitement ultérieur des appels de méthodes propres au périphérique.

BOOL AssignConnection(LPCTSTR lpszNewValue);

Si letype de connexion requis se trouve déjàdans la liste des connexions affectées,
celle-ci ne change pas. Seul le type de connexion actuel est remplacé par le type
demandé. Ilest normal d'appeler la méthode AssignConnection surle même objet
plusieurs fois lors de l'obtention et de la définition de valeurs propres à la
connexion.

AssignConnection renvoie VRAI si le type de connexion transmis existe sur
l'ordinateur et est affecté avec succès ou déjà affecté. Il renvoie FAUX si le type
de connexion requis n'existe pas sur l'ordinateur ou si le nombre de connexions
affectées a déjà atteint le maximum.

Un objethôte pcAnywherepeut prendreen chargejusqu'à deuxtypes deconnexion
affectés. Laméthode AssignConnection renvoie FAUX si elle détecte une tentative
de dépassement de cette limite.

Les types de connexion suivants sont disponibles :

■ COM1

objet CHostData

79Définitions d'objets Visual C++

■ COM2

■ COM3

■ COM4

■ SPX

■ NetBIOS

Définitions d'objets Visual C++

80

objet CHostData

■ TCP/IP

■ RNIS via CAPI 2.0

■ DEFAULT TAPI

Le nom d'un périphérique TAPI peut également servir de type de connexion.
DEFAULT TAPIutilise le premier périphérique TAPItrouvé dansle système. Pour
utiliser un périphérique TAPI spécifique, utilisez FirstConnectionType() et
NextConnectionType() pour rechercher les périphériques disponibles.

Le code suivant désaffecte un type de connexion. Après avoir désaffecté un type
de connexion, la connexion affectée restante, s'il y en a une, devient le type de
connexion actuel pour les appels ultérieurs de méthode propres au périphérique.

BOOL UnassignConnection(LPCTSTR lpszNewValue);

Le code suivant définit la parité des communications :

BSTR GetComParity();

void SetComParity(LPCTSTR lpszNewValue);

Les valeurs de parité de communication sont les suivantes :

■ Aucune

■ Impaire

■ Paire

■ Marque

■ Espace

Le code suivant définit les niveaux de contrôle de flux :

BSTR GetComFlowControl();void SetComFlowControl(LPCTSTR

lpszNewValue);

Les valeurs de contrôle de flux sont les suivantes :

■ <Aucun>

■ XONXOFF

■ RTS/CTS

■ LES DEUX

Le code suivant définit les valeurs de début de connexion :

BSTR GetComStartedBy();

void SetComStartedBy(LPCTSTR lpszNewValue);

Les valeurs de début de connexion sont les suivantes :

■ Toujours connecté

■ Détection de porteuse (DCD)

■ Prêt à émettre (CTS)

■ Ensemble de données prêt (DSR)

■ Signal de sonnerie (RI)

■ Réception 2 <CR>

■ Réponse du modem

Le code suivant définit les valeurs de fin de connexion :

BSTR GetComEndedBy();

void SetComEndedBy(LPCTSTR lpszNewValue);

Les valeurs de fin de connexion sont les suivantes :

■ Toujours connecté

■ Détection de porteuse (DCD)

objet CHostData

81Définitions d'objets Visual C++

■ Prêt à émettre (CTS)

■ Ensemble de données prêt (DSR)

■ Signal de sonnerie (RI)

Le code suivant définit la vitesse de connexion :

long GetComSpeed();

void SetComSpeed(long nNewValue);

Les valeurs de vitesse de connexion sont les suivantes :

■ 110

■ 300

■ 600

■ 1200

■ 2400

■ 4800

■ 9600

■ 19200

■ 38400

Définitions d'objets Visual C++

82

objet CHostData

■ 57600

■ 115200

Détails de périphérique NetBios

Définit le numéro de LANA (adaptateur réseau) à utiliser pour cette connexion.

short GetLanaNumber();void SetLanaNumber(short nNewValue);

Détails de périphérique NASI/NCSI

Définit le nom de l'utilisateur pour le serveur NASI.

BSTR GetNasiUserName();

void SetNasiUserName(LPCTSTR lpszNewValue);

Définit le mot de passe de l'utilisateur pour le serveur NASI.

BSTR GetNasiPassword();

void SetNasiPassword(LPCTSTR lpszNewValue);

Définit le nom de session NASI.

BSTR GetNasiSessionName();

void SetNasiSessionName(LPCTSTR lpszNewValue);

BOOL GetNasiSessionNameAvailable();

void SetNasiSessionNameAvailable(BOOL bNewValue);

Spécifie le serveur NASI à utiliser.

BOOL NasiServer();

BSTR GetNasiServerName();

void SetNasiServerName(LPCTSTR lpszNewValue);

Spécifie le service NASI à utiliser.

BOOL NasiService();

BSTR GetNasiServiceName();

void SetNasiServiceName(LPCTSTR lpszNewValue);

Spécifie le port NASI à utiliser.

BOOL NasiPort();

BSTR GetNasiPortName();

void SetNasiPortName(LPCTSTR lpszNewValue);

BOOL GetNasiSelectOnConnect();

void SetNasiSelectOnConnect(BOOL bNewValue);

Détails de périphérique RNIS via CAPI2.0

Active laliaison de canaux (utilise deux canaux RNIS pour uneconnexion) siVRAI.

BOOL GetCapiChannelBonding();

void SetCapiChannelBonding(BOOL bNewValue);

Définit touteextension CAPIsupplémentaire nécessairepour les communications.

BSTR GetCapiExtensions();

void SetCapiExtensions(LPCTSTR lpszNewValue);

Méthodes d'objet hôte

Les tableauxsuivants décrivent les méthodes normales de l'objet (elles neservent
pas à obtenir et à définir les propriétés de l'objet).

objet CHostData

83Définitions d'objets Visual C++

Méthode

short ConnectionTypes();

BSTR
FirstConnectionType(); et
BSTR
NextConnectionType();

BOOL
FindConnectionType(LPCTSTR
lpszConnectionType);

short
MaxAssignedConnections()

valeur renvoyés

Valeur retournée
= Court

Valeur renvoyée
= BSTR

Paramètre =
LPCTSTR
lpszConnectionTyp

Valeur renvoyée
= booléen

Valeur retournée
= Court

DescriptionParamètre ou

Renvoie le nombre de types de connexion
disponibles sur cet ordinateur

FirstConnectionType() et
NextConnectionType() servent à itérer
parmi lestypesde connexiondisponibles.
Ces fonctions renvoient un BSTR qui est
le nomd'un typede connexiondisponible.
Les typesde connexionrenvoyés peuvent
être utilisés avec la fonction
SetConnectionType().

La valeur renvoyée est le nom d'un type
de périphérique de connexion pris en
charge.

Le paramètre est le nom d'un type de
périphérique de connexion

La valeur renvoyée est VRAIE si ce type
de périphérique est disponible

Renvoie le nombre maximum de types de
connexion qui peuvent être affectés
simultanément (actuellement deux).

short
AssignedConnections()

Valeur retournée
= Court

Renvoie le nombre de types de connexion
affectés.

Définitions d'objets Visual C++

84

objet CHostData

Méthode

BSTR
FirstAssignedConnection();
et BSTR
NextAssignedConnection();

BOOL
FindAssignedConnection
(LPCTSTR
lpszConnectionType);

short CountryCodes();

BSTR FirstCountryCode();
et BSTR
NextCountryCode();

valeur renvoyés

Valeur renvoyée
= BSTR

Paramètre =
LPCTSTR
lpszConnectionTyp

Valeur renvoyée
= booléen

Valeur retournée
= Court

Valeur renvoyée
= BSTR

DescriptionParamètre ou

FirstAssignedConnection() et
NextAssignedConnection() serventà itérer
parmi les connexions affectées. Ces
fonctions renvoient un BSTR, qui est le
nom d'un type de connexion affecté. Les
types deconnexion renvoyéspeuvent être
utilisés avec la fonction
AssignConnection().

La valeur renvoyée est le nom d'un type
de périphérique de connexion pris en
charge.

Le paramètre est le nom d'un type de
périphérique de connexion

La valeur renvoyée est VRAI si ce type de
périphérique est actuellement affecté

Renvoie le nombre d'indicatifs
internationaux disponibles.

FirstCountryCode() etNextCountryCode()
servent à itérer parmi la liste des
indicatifs internationauxdisponibles. Les
fonctions renvoient un BSTR qui est le
nom d'un indicatif international
disponible. Lesvaleurs renvoyéespeuvent
être utilisées avec la fonction
SetCountryCode().

La valeurrenvoyée est la première chaîne
d'indicatif international ou chaîne
suivante.

BOOL ReadObject(LPCTSTR
lpszPassword);

Parameter =
LPCTSTR
lpszPassword

Valeur renvoyée
= booléen

Lit les données d'objet à partir du fichier
d'objet hôte.

Le paramètre est le mot de passe objet

La valeur renvoyée est VRAI si l'objet est
lancé avec succès.

objet CHostDataEx

85Définitions d'objets Visual C++

Méthode

BOOL
WriteObject(LPCTSTR
lpszPassword);

objet CHostDataEx

L'objet CHostDataEx contient la même fonction que l'objet CHostData, avec les
méthodes supplémentaires Get et Set (obtenir et définir) suivantes :

BOOL GetReadProtection();

void SetReadProtection(BOOL bNewValue);

BOOL GetWriteProtection();

void SetWriteProtection(BOOL bNewValue);

BSTR GetPassword(); //Returns "NON IMPLEMENTE"

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); //Sets ActiveKbds

short GetInactiveTimeout();

void SetInactiveTimeout(short nNewValue);

short GetCryptReqLevel();

void SetCryptReqLevel(short nNewValue);

BOOL GetCryptRefuseLower();

void SetCryptRefuseLower(BOOL bNewValue);

valeur renvoyés

Paramètre =
LPCTSTR
lpszPassword

Valeur renvoyée
= booléen

DescriptionParamètre ou

Ecrit les données d'objet dans le fichier
d'objet hôte.

Le paramètre est le mot de passe objet

La valeur renvoyée est VRAI si l'objet est
lancé avec succès.

Définitions d'objets Visual C++

86

objet CHostDataEx

short GetAuthenticationType();

void SetAuthenticationType(short nNewValue);

BOOL GetLockSystemWhileWait();

void SetLockSystemWhileWait(BOOL bNewValue);

BOOL GetMinimizeOnLaunch();

void SetMinimizeOnLaunch(BOOL bNewValue);

BOOL GetRunAsService();

void SetRunAsService(BOOL bNewValue);

short GetConnLostWait();

void SetConnLostWait(short nNewValue);

BOOL GetConnLostHostOpts();

void SetConnLostHostOpts(BOOL bNewValue);

BOOL GetEnableConnLostSecurity();

void SetEnableConnLostSecurity(BOOL bNewValue);

short GetConnLostSecurity();

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);

Exemple de code Visual C++ pour la fonctionnalité Hôte

L'exemple suivant de fonction Visual C++ crée un objet hôte, définit son type de
connexion surTCP/IP, définitle nomde l'ordinateur sur l'adresse TCP/IP transmise
à la fonction, puis lance l'objet hôte.

BOOL LaunchTCPHost(LPCTSTR lpszAddress)

{

BOOL bReturn = FALSE;

CHostDataManager hostDM;

CHostData hostData;

// Créer d'abord le CHostDataManager

hostDM.CreateDispatch( _T( "WINAWSVR.BeHostDataManager") );

// Créer ensuite CRemoteData et le rattacher

hostData.AttachDispatch(hostDM.CreateObject("Test", 0) );

objet CHostDataEx

87Définitions d'objets Visual C++

// Définir à présent les propriétés requises

hostData.SetConnectionType("TCP/IP");

// Enregistrer les données de l'objet

if (hostData.WriteObject(0))

{

// Et le lancer

if (hostData.Launch())

bReturn = TRUE;

}

// Libérer l'objet hôte.

hostData.ReleaseDispatch();

return (bReturn);

}

Définitions d'objets Visual C++

88

fonctions awrem32

fonctions awrem32

Le tableau suivant décrit les fonctions Awrem32, y compris les paramètres et les
valeurs renvoyées pour la gestion des connexions entre un hôte et un ordinateur
distant :

Méthode

boolean awConnect(BSTR
FileName);

boolean awDisconnect();

boolean
FileXferFromHost(BSTR
HostFile);

valeur renvoyés

Paramètre = Nom
comme chaîne

Valeur renvoyée=
booléen

Valeur renvoyée=
booléen

Paramètre =
HostFile comme
chaîne

DescriptionParamètre ou

Crée la connexion à l'ordinateur hôte.

Le paramètre est le nom intégralement
qualifié du fichier .chf contenant les
informations sur l'ordinateur hôte.

La valeur renvpyée exécute la
commande

Déconnecte l'ordinateur hôte.

Après avoir appelé cette fonction, le
programme appelant doit supprimer
l'objet (C++ - delete IAwrem32X*, VB –
set ObjectName = Nothing;).

Copie un fichier de l'ordinateur hôte
vers l'ordinateur distant. Les
paramètres peuvent contenir des
caractères génériques.

Le paramètrecontient lechemin d'accès
intégralement qualifié du fichier à
copier à partir de l'ordinateur hôte. Les
chaînes de fichier hôte et de fichier
distant ne sont pas obligatoirement
identiques.

boolean
FileXferFromHost(BSTR
RemoteFile);

boolean FileXferFromHost

Paramètre =
RemoteFile
comme chaîne

booléen

Copie un fichier de l'ordinateur hôte
vers l'ordinateur distant. Les
paramètres peuvent contenir des
caractères génériques.

Le paramètrecontient lechemin d'accès
de destination et le nom de fichier,
entièrement qualifiés. Les chaînes de
fichier hôte et de fichierdistant ne sont
pas obligatoirement identiques.

VRAI si la commande est exécutée.Valeur renvoyée=

fonctions awrem32

89Définitions d'objets Visual C++

Méthode

boolean
FileXferToHost(BSTR
HostFile);

boolean
FileXferToHost(BSTR
RemoteFile);

boolean FileXferToHost

valeur renvoyés

Paramètre =
HostFile comme
chaîne

Paramètre =
RemoteFile
comme chaîne

booléen

DescriptionParamètre ou

Copie un fichier de l'ordinateur distant
vers l'ordinateur hôte. Les paramètres
peuvent contenir des caractères
génériques.

Le paramètrecontient lechemin d'accès
de destination et le nom de fichier,
entièrement qualifiés. Les chaînes de
fichier hôte et de fichierdistant ne sont
pas obligatoirement identiques.

Copie un fichier de l'ordinateur distant
vers l'ordinateur hôte. Les paramètres
peuvent contenir des caractères
génériques.

Le paramètrecontient lechemin d'accès
intégralement qualifié du fichier à
copier à partir de l'ordinateur distant.
Les chaînes de fichier hôte et de fichier
distant ne sont pas obligatoirement
identiques.

VRAI si la commande est exécutée.Valeur renvoyée=

boolean
CreateFolderOnHost(BSTR
FolderName);

Paramètre = Nom
de dossier comme
chaîne

Valeur renvoyée=
booléen

Crée unnouveau dossiersur l'ordinateur
hôte. Cette fonction crée un dossier
temporaire surl'ordinateur distant,puis
copie ce dossier sur l'ordinateur hôte.

Ce paramètre contient le lecteur et le
chemin d'accès du dossier sur
l'ordinateur hôte.

La valeur renvoyée est VRAI si la
commande est exécutée.

Définitions d'objets Visual C++

90

fonctions awrem32

Méthode

boolean
ExecuteHostFile(BSTR
FileName);

BSTR GetError();

short ConnectionStatus();

valeur renvoyés

Paramètre = Nom
de fichier comme
chaîne

Valeur renvoyée=
booléen

Valeur renvoyée=
Chaîne

Valeur retournée
= Court

DescriptionParamètre ou

Exécute un fichier existant sur
l'ordinateur hôte.Cette fonctionne peut
exécuter que les fichiers batch, de
commandes et exécutables. Elle
n'exécute pas les fichiers associés aux
exécutables. Par exemple, elle n'ouvre
pas MicrosoftWord sivous exécutez un
fichier .doc.

Contient le chemin d'accès
intégralement qualifié du fichier sur
l'ordinateur hôte.

La valeur renvoyée est VRAI si la
commande est exécutée.

Renvoie ladernière erreurgénérée dans
Awrem32, comme chaîne.

Renvoie l'état courant de la connexion
à l'ordinateur hôte.

Les valeurspossibles sontles suivantes:

■ -1 = Connexion perdue

■ 0 = Aucune connexion

■ 1 = Session connectée

Index

A

automatisation OLE. Se reporter à serveur

d'automatisation pcAnywhere

Awrem32

fonctions 58, 88

B

bibliothèques API 14
bibliothèques de type 14

C

C++.. Se reporter à Visual C++
CHostData

utilisation de Visual Basic 37
utilisation de Visual C++ 77

CHostDataEx

utilisation de Visual Basic 48
utilisation de Visual C++ 85

CHostDataManager

utilisation de Visual Basic 34
utilisation de Visual C++ 73

connexions

arrêt 58, 88
démarrage 37, 58, 65, 88
erreurs de retour 90
retour de l'état 60, 90

connexions CAPI

propriétés de l'hôte 48, 83
propriétés des distants 30, 70

connexions NetBIOS

propriétés de l'hôte 47, 82
propriétés des distants 29, 70

connexions par modem

sur l'hôte

indicatifs internationaux 84
périphériques TAPI 80
propriétés COM 44, 79
propriétés de numérotation 43

sur l'ordinateur distant

indicatifs internationaux 71

périphériques TAPI 68
propriétés COM 26, 68
propriétés de numérotation 25

connexions réseau

sur l'hôte

propriétés NetBIOS 47, 82

sur l'ordinateur distant

propriétés NetBIOS 29, 70
contrôle de flux 27, 44, 68, 80
contrôleurs d'automatisation

à propos de Visual Basic 12
à propos de Visual C++ 14

CRemoteData

utilisation de Visual Basic 21
utilisation de Visual C++ 66

CRemoteDataEx

utilisation de Visual Basic 31
utilisation de Visual C++ 72

CRemoteDataManager

utilisation de Visual Basic 18
utilisation de Visual C++ 62

D

définition des classes

affichage 15
importing (importation) 14

dossiers

création sur l'hôte 59, 89

E

erreurs

renvoi 59, 90

état

renvoi 60, 90

exemples de code

Visual Basic 32, 56
Visual C++ 72, 87

Index92

F

fichiers

exécution sur l'hôte 59, 90

G

GUID 11

I

identificateurs. Se reporter à GUID
indicatifs internationaux

sur l'hôte 84
sur l'ordinateur distant 71

M

moteur distant

inscription automatique 11
inscription manuelle 12

mots de passe

sur les objets distants 72
sur les objets hôte 84

O

objets distants

création 65
détails du périphérique 68
fichiers 19–20, 35, 63–64
méthodes 71
mots de passe 72
propriétés de numérotation 25
répertoires 18, 62
suppression 65

objets hôte

création 76
démarrage 37, 77
détails du périphérique 79
méthodes 83
mots de passe 84
propriétés de numérotation 43
recherche 35–36, 74, 76
répertoires 34, 74
suppression 36, 77

P

paramètres de chiffrement

sur l'hôte 48, 85
sur l'ordinateur distant 31–32, 72

parité 27, 44, 68, 80

Périphériques COM

détails de périphérique distant 26, 68
détails de périphérique hôte 44, 79

périphériques NASI 82
périphériques NCSI 82
périphériques TAPI

sur l'hôte 80
sur l'ordinateur distant 68

périphériques.. Se reporter à types de connexion

R

RNIS

connexions CAPI

propriétés de l'hôte 48, 83
propriétés des distants 30, 70

S

serveur d'automatisation pcAnywhere

à propos de 10
accès avec Visual Basic 12
accès avec Visual C++ 14
bibliothèques de type 14
exemples d'utilisation 10
inscription des GUID 11

serveur d'automatisation.. Se reporter à serveur

d'automatisation pcAnywhere

T

transfert de fichiers

à partir de l'hôte 58, 88
vers l'hôte 59, 89

types de connexion

attribution 42
désaffectation 42
propriétés de l'hôte 39, 79, 83
propriétés des distants 23, 68, 71

V

Visual Basic

accès au serveur d'automatisation

pcAnywhere 12
exemples de code 32, 56
fonctions awrem32 58
objet CHostData 37
objet CHostDataEx 48
objet CHostDataManager 34
objet CRemoteData 21
objet CRemoteDataEx 31

objet CRemoteDataManager 18

Visual C++

accès au serveur d'automatisation

pcAnywhere 14
ajout de Winawsvr.h 16
exemples de code 72, 87
fonctions awrem32 88
importation de classes 14
objet CHostData 77
objet CHostDataEx 85
objet CHostDataManager 73
objet CRemoteData 66
objet CRemoteDataEx 72
objet CRemoteDataManager 62

W

Winawsvr

exécutable 12
fichier d'en-tête 16
objets

CHostData 37, 77
CHostDataEx 48, 85
CHostDataManager 34, 73
CRemoteData 21, 66
CRemoteDataEx 31, 72
CRemoteDataManager 18, 62

93Index