SYMANTEC pcAnywhere v12.5 User Manual [fr]

Page 1

Guide d'automatisation OLE

Page 2
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.
Page 3
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
Page 4

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
Page 5
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.
Page 6
Ressources des accords de maintenance
Pour touteinformation sur les accords de maintenance, veuillez contacter l'équipe administrative responsable de votre région :
contractsadmin@symantec.comAsie-Pacifique et Japon
semea@symantec.comEurope, Moyen-Orient et Afrique
supportsolutions@symantec.comAmé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.
Page 7

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
Page 8
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
Page 9
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 ;
Page 10
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
Page 11
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.
Page 12
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.
Page 13
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"
Page 14
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.
Page 15
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;
Page 16
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.
Page 17
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.
Page 18
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.
Page 19
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.
Page 20
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 =
Page 21

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.
Page 22
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.
Page 23
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.
Page 24
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
Page 25
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.
Page 26
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.
Page 27
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)
Page 28
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
Page 29
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.
Page 30
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.
Page 31

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
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.
Page 32
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)
Page 33
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
Page 34
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.
Page 35
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
Page 36
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
Page 37

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.
Page 38
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.
Page 39
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.
Page 40
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
Page 41
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.
Page 42
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
Page 43
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.
Page 44
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
Page 45
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.
Page 46
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)
Page 47
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.
Page 48
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
Page 49
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
Page 50
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.
Page 51
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 hote
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.
Page 52
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 hote
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.
Page 53
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
Page 54
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.
Page 55
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 hote
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
Page 56
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 hote
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
Page 57
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")
Page 58
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
Page 59
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.
Page 60
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
Page 61
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.
Page 62
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.
Page 63
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.
Page 64
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.
Page 65
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.
Page 66
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.
Page 67
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);
Page 68
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 :
Page 69
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)
Page 70
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);
Page 71

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.
Page 72
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;
Page 73

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 :
Page 74
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.
Page 75
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.
Page 76
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.
Page 77

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.
Page 78
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);
Page 79

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
Page 80
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);
Page 81
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
Page 82
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);
Page 83
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.
Page 84
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.
Page 85

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.
Page 86
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);
Page 87

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);
}
Page 88
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=
Page 89
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.
Page 90
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
Page 91

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
Page 92
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
Page 93
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
Loading...