Symantec pcAnywhere v12.5 Manuel utilisateur

Guide d'automatisation OLE
Guide d'automatisation OLE
Mentions légales
Copyright © 2008 Symantec Corporation. Tous droits réservés.
Symantec et le logo Symantec sont des marques commerciales ou déposées de Symantec
Corporation ou de ses filiales, aux Etats-Unis et dans d'autres pays., Les autres noms peuvent
ê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 de source ouverte ou de logiciel libre. le contrat de licence 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 distribution et sa décompilation/ingénierie inverse. Ce document 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 DOCUMENTATION EST FOURNIE "EN L'ETAT", ET TOUTE GARANTIE OU CONDITION
D'AUCUNE SORTE, EXPRESSE OU IMPLICITE, Y COMPRIS, SANS QUE CELA SOIT
LIMITATIF, LES GARANTIES OU CONDITIONS IMPLICITES DE QUALITE MARCHANDE,
D'ADEQUATION A UN USAGE PARTICULIER OU DE RESPECT DES DROITS DE PROPRIETE
INTELLECTUELLE EST TENUE POUR JURIDIQUEMENT NON VALIDE. SYMANTEC
CORPORATION NE POURRA PAS ETRE TENUE RESPONSABLE DE DOMMAGES DIRECTS
OU INDIRECTS EN RELATION AVEC LE CONTENU OU L'UTILISATION DE LA PRESENTE
DOCUMENTATION. LES INFORMATIONS PRESENTES DANS CETTE DOCUMENTATION
SONT SUJETTES A MODIFICATION SANS PREAVIS.
Le logiciel et la documentation sous licence sont considérés "logiciel informatique
commercial" et "documentation de logiciel informatique commercial" t sujets aux droits
restreints selon les définitions des sections FAR 12.212 et DFARS 227.7202 autant
qu'applicables, ainsi que toute régulation issue de celles-ci. Toute utilisation, modification,
reproduction de version, performance, affichage ou divulgation du logiciel et de la
documentation sous licence, par le gouvernement des Etats-Unis, ne peut s'effectuer que
selon les termes de cet accord.
Symantec Corporation
20330 Stevens Creek Blvd.
Cupertino, CA 95014
http://www.symantec.fr
Fabriqué en Irlande.
10 9 8 7 6 5 4 3 2 1
Support technique
Le support technique de Symantec gère les centres de support au niveau mondial.
Le support technique a pour rôle essentiel de répondre à des demandes spécifiques
sur les caractéristiques et les fonctions des produits. Il est également responsable
de la création des articles de notre base de données en ligne. Le groupe de support
technique collabore avec les autres entités de 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 des mises à jour
des définitions de virus.
Parmi les offres de maintenance de Symantec, il faut citer :
■
Une gamme d'options de support pour vous 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'entrer en contact avec le support technique, assurez-vous d'avoir satisfait
la configuration requise indiquée dans votre documentation produit. En outre,
vous devriez être à l'ordinateur sur lequel le problème s'est produit, au cas où il
serait nécessaire de recréer le problème.
Quand vous entrez en contact avec le support technique, ayez s'il vous plaît les
informations suivantes disponibles :
■
Niveau de version du produit
■
Informations concernant le matériel
■
Mémoire disponible, espace disque, informations NIC
■
Système d'exploitation
■
Version et niveau de correctif
■
Topologie réseau
■
Routeur, passerelle, et informations d'adresse IP
■
Description du problème :
■
Messages d'erreur et fichiers journaux
■
Dépannage effectué avant d'entrer en contact avec Symantec
■
Changements de configuration récents du logiciel et changements de réseau
Licence et enregistrement
Si votre produit Symantec requiert un enregistrement ou une clé de licence, 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èmes des 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érales sur les produits (caractéristiques, langues disponibles,
distributeurs) ;
■
dernières informations sur les mises à jour et mises à niveau des produits ;
■
informations sur les assurances de mise à jour et les contrats de maintenance ;
■
informations au sujet de l'achat de programmes Symantec ;
■
conseil sur les options de support technique de Symantec ;
■
questions avant-vente non techniques ;
■
questions concernant les CD-ROM ou les manuels.
Ressources des accords de maintenance
Pour toute information sur les accords de maintenance, veuillez contacter l'équipe
administrative responsable de votre région :
Asie-Pacifique et Japon
contractsadmin@symantec.com
Europe, Moyen-Orient et Afrique
semea@symantec.com
Amérique du Nord et Amérique latine
supportsolutions@symantec.com
Services supplémentaires destinés aux entreprises
Symantec propose un ensemble complet de services qui vous permettront de
rentabiliser au maximum vos produits Symantec, de développer vos 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 Early Warning Solutions 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.
Services de supervision de la
sécurité
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.
Services de conseil
Symantec Consulting Services garantissent une expertise technique sur site
apportée directement par Symantec ou ses partenaires agréés. Symantec
Consulting Services propose une série d'options préconçues et personnalisables
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.
Services de formation
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.
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.
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 ......................................................
Méthodes CRemoteDataManager ....................................................
Propriétés CRemoteData ...............................................................
Propriétés du type de connexion ...............................................
Propriétés de numérotation .....................................................
Propriétés de périphérique COM ...............................................
Propriétés de périphérique NetBIOS ..........................................
Propriétés de périphérique RNIS via CAPI 2.0 ..............................
objet CRemoteDataEx ...................................................................
Exemple de code Visual Basic pour la fonction distant ...................
Méthodes CHostDataManager ........................................................
Propriétés CHostData ...................................................................
Propriétés du type de connexion ...............................................
Méthode AssignConnection(type de connexion) ...........................
Méthode UnassignConnection (type de connexion) .......................
17
18
21
23
25
26
29
30
31
32
34
37
39
42
42
8
Table des matières
Propriétés de numérotation .....................................................
Propriétés de périphérique COM ...............................................
Propriétés de périphérique NetBIOS ..........................................
Propriétés de périphérique RNIS via CAPI 2.0 ..............................
objet CHostDataEx .......................................................................
Exemple de code Visual Basic pour la fonctionnalité hôte. ..............
fonctions awrem32 .......................................................................
Chapitre 3
Définitions d'objets Visual C++ ........................................ 61
A propos des objets Visual C++ .......................................................
Méthodes CRemoteDataManager ....................................................
objet CRemoteData .......................................................................
Méthodes Get et Set (obtenir et définir) ......................................
Méthodes de détail d'objet distant .............................................
Méthodes d'objet distant .........................................................
objet CRemoteDataEx ...................................................................
Exemple de code Visual C++ pour la fonctionnalité du
distant ...........................................................................
Méthodes CHostDataManager ........................................................
objet CHostData ...........................................................................
Méthodes Get et Set (obtenir et définir) ......................................
Méthodes de détail d'objet hôte .................................................
Méthodes d'objet hôte .............................................................
objet CHostDataEx .......................................................................
Exemple de code Visual C++ pour la fonctionnalité Hôte ................
fonctions awrem32 .......................................................................
Index
43
44
47
48
48
56
58
61
62
66
66
68
71
72
72
73
77
77
79
83
85
87
88
.................................................................................................................... 91
Chapitre
1
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
■
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 un script 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 ;
10
Utilisation de l'automatisation OLE avec Symantec pcAnywhere
A propos du serveur d'automatisation pcAnywhere
un contrôleur
d'automatisation OLE ;
une application ou outil de développement pouvant
atteindre et contrôler les composants exposés par le serveur
d'automatisation OLE.
Vous pouvez utiliser tout langage de programmation
prenant en charge l'automatisation OLE. Les deux langages
de programmation les plus courants sont Microsoft Visual
Basic et Microsoft Visual C++.
Une application externe accède à un serveur d'automatisation en se connectant
au serveur, puis en demandant l'accès à une ou plusieurs de ses interfaces publié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.
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 vous créez un objet hôte dans pcAnywhere, le premier modem
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 de transferts automatiques de fichiers entre ordinateurs à des
fins d'audit ou d'archivage
Utilisation de l'automatisation OLE avec Symantec pcAnywhere
Avant de commencer
■
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 connecter au serveur d'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 distinct est 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 est installé, vous pouvez 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.
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
1
Pour ouvrir Symantec pcAnywhere, effectuez l'une des opérations suivantes :
■
Sur le bureau, cliquez deux fois sur l'icône du programme Symantec
pcAnywhere.
11
12
Utilisation de l'automatisation OLE avec Symantec pcAnywhere
Avant de commencer
■
Dans la barre des tâches de Windows, cliquez sur Démarrer>
Programmes> Symantec pcAnywhere.
2
Dans la fenêtre du Gestionnaire pcAnywhere, cliquez sur Distants.
3
Cliquez deux fois sur un élément de connexion distante.
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-forme prenant en charge l'automatisation OLE. Les deux plates-formes
les plus répandues qui prennent 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.
Utilisation de l'automatisation OLE avec Symantec pcAnywhere
Avant de commencer
Pour accéder au serveur d'automatisation pcAnywhere avec Visual Basic
1
Ajoutez une paire de variables objet pour chaque objet pcAnywhere auquel
accéder.
Par exemple, pour travailler avec des objets distant, dimensionnez un objet
RemoteDataManager et RemoteDataObject.
2
Utilisez RemoteDataManager pour le rattachement au gestionnaire de données
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.
3
4
Une fois qu'il existe un objet gestionnaire de données valide, utilisez-le pour
effectuer les opérations suivantes :
■
Déterminer le répertoire en cours
■
Accéder à un autre répertoire
■
Enumérer les fichiers objet de données associés dans le répertoire en cours
■
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
obtenir (Get) ou définir (Set) ses propriétés.
La syntaxe de 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"
13
14
Utilisation de l'automatisation OLE avec Symantec pcAnywhere
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 les informations concernant ses interfaces et ses méthodes vers les clients
d'automatisation, qui sont écrits en Visual C++. Ces bibliothèques de 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
Contient les informations nécessaires pour se connecter au serveur
d'automatisation pcAnywhere et accéder à ses interfaces.
Awrem32.tlb
Contient les informations nécessaires au contrôle des connexions
pcAnywhere.
Les procédures suivantes expliquent comment importer les bibliothèques de type
du serveur d'automatisation pcAnywhere et afficher les classes ayant été ajoutées
à votre application.
Pour importer des classes
1
Créez une application MFC dans Visual C++.
2
Dans le menu Affichage, cliquez sur Assistant de classe.
Utilisation de l'automatisation OLE avec Symantec pcAnywhere
Avant de commencer
3
Dans la boîte de dialogue Assistant de classe, cliquez sur Ajouter une classe,
puis cliquez sur Depuis une bibliothèque de type.
4
Cliquez deux fois sur winawsvr.tlb.
5
Dans la boîte de dialogue Confirmer Classes, cliquez sur OK pour importer
toutes les définitions de classe.
6
Dans la boîte de dialogue Assistant de classe, cliquez sur Ajouter une classe,
puis cliquez sur Depuis une bibliothèque de type.
7
Cliquez deux fois sur awrem32.tlb.
8
Dans la boîte de dialogue Confirmer Classes, cliquez sur OK pour importer
toutes les définitions de classe.
9
Dans la boîte de dialogue Assistant de classe, cliquez sur OK pour terminer
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
1
Dans Visual C++, ouvrez votre application MFC.
2
Dans la fenêtre de l'espace de travail, cliquez sur l'onglet ClassView.
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 du serveur d'automatisation pcAnywhere. Il est inutile d'éditer ces fichiers ;
15
16
Utilisation de l'automatisation OLE avec Symantec pcAnywhere
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
1
Dans Visual C++, ouvrez votre application MFC.
2
Dans la fenêtre de l'espace de travail, cliquez sur l'onglet FileView.
Démarrage des objets OLE hôte et distant
Symantec pcAnywhere nécessite que tous les objets hô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'automatisation OLE, reportez-vous aux documents
de référence suivants (en anglais) :
■
Box, Don. 1998. Essential COM. Reading, Mass.: Addison-Wesley.
■
Horton, Ivor. 1997. Commencer MFC Programming. Birmingham, RU : Wrox
Press.
■
Rogerson, Dale. 1997. Inside COM. Redmond, Wash.: Microsoft Press.
■
Templeman, Julian. 1997. Beginning MFC COM Programming. Birmingham,
RU : Wrox Press.
Chapitre
2
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
■
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
contient les informations nécessaires pour se connecter au serveur
d'automatisation pcAnywhere et accéder à ses interfaces.
Awrem32
Contient les informations nécessaires au contrôle des connexions
pcAnywhere.
Le Tableau 2-1 décrit les objets qui composent Winawsvr.
18
Définitions d'objets Visual Basic
Méthodes CRemoteDataManager
Tableau 2-1
Objets Winawsvr
Objet
Description
Référence
CRemoteDataManager
Fournit les méthodes pour créer, ouvrir,
modifier, enregistrer et supprimer les
objets CRemoteData.
Se reporter à "Méthodes
CRemoteDataManager" à la page 18.
CRemoteData
Définit les paramètres permettant
d'accéder à la fonction distant de
pcAnywhere et de la contrôler.
Se reporter à "Propriétés CRemoteData"
à la page 21.
CHostDataManager
Fournit les méthodes pour créer, ouvrir,
modifier, enregistrer et supprimer les
objets ChostData.
Se reporter à "Méthodes
CHostDataManager" à la page 34.
CHostData
Définit les paramètres permettant
Se reporter à "Propriétés CHostData"
d'accéder à la fonction hôte de pcAnywhere à la page 37.
et de la contrôler.
Se reporter à "objet CHostDataEx"
à la page 48.
Se reporter à "objet CRemoteDataEx"
à la page 31.
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éthodes CRemoteDataManager
Méthode
CRemoteDataManager
Paramètre ou valeur Description
renvoyés
CurrentDirectory()
Valeur renvoyée =
chaîne
Renvoie le chemin d'accès complet
du dossier actuel dans lequel les
objets distants pcAnywhere sont
stockés.
Définitions d'objets Visual Basic
Méthodes CRemoteDataManager
Méthode
CRemoteDataManager
Paramètre ou valeur Description
renvoyés
ChangeDirectory(nouveau
répertoire)
Paramètre =
NewDirectory
FindFirst(schéma)
Paramètre = schéma en Trouve le premier fichier d'objet
tant que chaîne
distant de pcAnywhere (*.chf) dans
le rdossier en cours ; classe les noms
de fichiers de schémas sur base du
schéma spécifié de nom de fichier
(un astérisque [*] permet de trouver
tous les fichiers du dossier en cours)
FindFirst(nom)
Paramètre = Nom
comme chaîne
Tampon de retour pour le chemin
d'accès complet du fichier d'objet
distant (*chf) correspondant au
schéma spécifié
FindNext(nom)
Paramètre = Nom
comme chaîne
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().
FindNext(nom)
Valeur renvoyée =
booléen
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)
Paramètre = Nom
comme chaîne
Nom intégralement qualifié du
fichier d'objet distant à charger.
RetrieveObject(mode
d'accès)
Paramètre = Mode
d'accès comme valeur
entière
Spécifie comment cet objet doit être
utilisé. Ce paramètre est lié à la
protection par mot de passe.
Change le dossier actuel dans lequel
les objets distants pcAnywhere sont
stockés.
Les options sont les suivantes :
RetrieveObject(mot de
passe)
Paramètre = Mot de
passe comme chaîne
■
0 = Non spécifié
■
1 = Afficher uniquement
■
2 = Afficher et modifier
■
3 = Exécuter
Mot de passe de l'objet. Peut être
NULL.
19
20
Définitions d'objets Visual Basic
Méthodes CRemoteDataManager
Méthode
CRemoteDataManager
Paramètre ou valeur Description
renvoyés
RetrieveObjectEx(nom)
Paramètre = Nom
comme chaîne
Nom intégralement qualifié du
fichier d'objet distant à charger.
RetrieveObjectEx(mode
d'accès)
Paramètre = Mode
d'accès comme valeur
entière
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
RetrieveObjectEx(mot de
passe)
Paramètre = Mot de
passe comme chaîne
Mot de passe de l'objet. Peut être
NULL.
RetrieveObjectEx
Valeur renvoyée =
Objet
Objet CRemoteDataEx du fichier
spécifié.
CreateObject(nom)
Paramètre = Nom
comme chaîne
Crée un objet CRemoteData 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
Valeur renvoyée =
Objet
CRemoteData
CreateObjectEx(nom)
Paramètre = Nom
comme chaîne
Crée un objet CRemoteDataEx 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.
CreateObjectEx
Valeur renvoyée =
Objet
CRemoteDataEx
DeleteObject(nom)
Paramètre = Nom
comme chaîne
Nom intégralement qualifié du
fichier d'objet distant de l'objet à
supprimer.
DeleteObject(mot de passe) Paramètre = Mot de
passe comme chaîne
Mot de passe de l'objet
DeleteObject
VRAI si l'objet est supprimé.
Valeur renvoyée =
booléen
Définitions d'objets Visual Basic
Propriétés CRemoteData
Propriétés CRemoteData
Les propriétés et les paramètres disponibles pour l'objet CRemoteData sont affichés
comme suit.
Dans Tableau 2-3, remplacez les informations entre les chevrons par les valeurs
réelles.
Tableau 2-3
CRemoteData - Propriétés et paramètres
Propriété
Paramètre
Description
<CRemoteData>.ComputerName(chaîne)
Chaîne
Définit le nom ou l'adresse IP de l'ordinateur
hôte.
<CRemoteData>.PhoneNumber(chaîne)
Chaîne
Définit le numéro de téléphone de l'ordinateur
hôte.
<CRemoteData>.UseDialingProperties(Bool)
Bool
Définit les propriétés de numérotation du
système.
<CRemoteData>.RedialCount(entier)
Entier
Définit le nombre de tentatives de rappel avant
l'annulation de l'appel.
<CRemoteData>.RedialDelay(entier)
Entier
Définit le nombre de secondes d'attente entre
les tentatives de rappel.
<CRemoteData>.AutoLoginName(chaîne)
Chaîne
Définit le nom de l'utilisateur pour la
connexion automatique.
Pour plus d'informations sur l'utilisation de la
connexion aux domaines, reportez-vous à la
section :
Se reporter à "objet CRemoteDataEx"
à la page 31.
<CRemoteData>.AutoLoginPassword(chaîne)
Chaîne
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.
21
22
Définitions d'objets Visual Basic
Propriétés CRemoteData
Propriété
Paramètre
Description
<CRemoteData>.Password(chaîne)
Chaîne
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.
<CRemoteData>.ExecuteProtection (Bool)
Bool
Définit la nécessité d'un mot de passe pour
exécuter l'objet. Définir par mot de passe.
<CRemoteData>.ReadProtection(Bool)
Bool
Définit la nécessité d'un mot de passe pour
afficher les propriétés de l'objet distant. Définir
par mot de passe.
<CRemoteData>.WriteProtection(Bool)
Bool
Définit la nécessité d'un mot de passe pour
enregistrer les modification de l'objet distant.
Définir par mot de passe.
<CRemoteData>.LogSession (Bool)
Bool
Active et désactive la consignation des
sessions.
<CRemoteData>.RecordFile(chaîne)
Chaîne
Définit le nom et le chemin d'accès
intégralement qualifié du fichier
d'enregistrement de la session active.
<CRemoteData>.RecordSession(Bool)
Bool
Active et désactive la consignation
automatique de session.
<CRemoteData>.ReadObject(chaîne)
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.
<CRemoteData>.WriteObject(chaîne)
Chaîne
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.
Définitions d'objets Visual Basic
Propriétés CRemoteData
Tableau 2-4
CRemoteData - Propriétés et valeurs renvoyées
Propriété
Valeur
renvoyée
Description
String = <CRemoteData>.ComputerName
Chaîne
Renvoie le nom ou l'adresse IP de l'ordinateur
hôte
String = <CRemoteData>.PhoneNumber
Chaîne
Renvoie le numéro de téléphone de l'ordinateur
hôte
Bool = <CRemoteData>.UseDialingProperties
Bool
Renvoie les propriétés de numérotation du
système définies dans l'objet distant
Integer = <CRemoteData>.RedialCount
Entier
Renvoie le nombre de tentatives d'appel défini
dans l'objet distant
Integer = <CRemoteData>.RedialDelay
Entier
Renvoie le nombre de secondes d'attente entre
les tentatives de rappel.
String = <CRemoteData>.AutoLoginName
Chaîne
Renvoie le nom de l'utilisateur pour la
connexion automatique
Bool = <CRemoteData>.ExecuteProtection
Bool
Renvoie la valeur du paramètre
ExecuteProtection.
Bool = <CRemoteData>.ReadProtection
Bool
Renvoie la valeur du paramètre
ReadProtection.
Bool = <CRemoteData>.WriteProtection
Bool
Renvoie la valeur du paramètre
WriteProtection
Bool = <CRemoteData>.LogSession
Bool
VRAI si la consignation de session est activée.
String = <CRemoteData>.RecordFile
Chaîne
Renvoie le nom et le chemin d'accès
intégralement qualifié du fichier
d'enregistrement de la session.
Bool = <CRemoteData>.RecordSession
Bool
Renvoie la valeur du paramètre
d'enregistrement de session.
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.
23
24
Définitions d'objets Visual Basic
Propriétés CRemoteData
Tableau 2-5
Type de connexion - Propriétés et paramètres
Propriété
Paramètre
Description
<CRemoteData>.ConnectionType(chaîne)
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.
Tableau 2-6
Type de connexion - Propriétés et valeurs renvoyées
Propriété
Valeur
renvoyée
Description
String = <CRemoteData>.ConnectionTypes
Chaîne
Renvoie le type de connexion de l'objet distant.
Définitions d'objets Visual Basic
Propriétés CRemoteData
Propriété
Valeur
renvoyée
Description
Integer = <CRemoteData>.ConnectionType
Entier
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)
String = <CRemoteData>.FirstConnectionType
Chaîne
Renvoie le premier type de connexion
disponible.
String = <CRemoteData>.NextConnectionType
Chaîne
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.
Bool = <CRemoteData>.FindConnectionType(type Bool
de connexion)
VRAI si le type de connexion indiqué a été
trouvé dans la liste des types de connexion
disponibles.
Propriétés de numérotation
Le tableau suivant décrit les propriétés et les paramètres pour définir les 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.
25
26
Définitions d'objets Visual Basic
Propriétés CRemoteData
Tableau 2-7
Propriétés de numérotation - Propriétés et paramètres
Propriété
Paramètre
Description
<CRemoteData>.AreaCode(chaîne)
Chaîne
Définit les propriétés de numérotation de code
de zone pour les connexions par modem
<CRemoteData>.CountryCode(chaîne)
Chaîne
Définit les propriétés de numérotation
d'indicatif international pour les connexions
par modem
Le tableau suivant définit les propriétés et les valeurs renvoyées pour les 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
Propriété
Valeur
renvoyée
Description
String = <CRemoteData>.AreaCode
Chaîne
Renvoie les propriétés de numérotation de code
de zone
String= <CRemoteData>.CountryCode
Chaîne
Renvoie les propriétés de numérotation
d'indicatif international
Integer = <CRemoteData>.CountryCodes
Entier
Renvoie le nombre d'indicatifs internationaux
disponibles.
String= <CRemoteData>.FirstCountryCode
Chaîne
Renvoie le premier indicatif de pays
apparaissant dans la liste du système
d'exploitation.
String= <CRemoteData>.NextCountryCode
Chaîne
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 tous les indicatifs internationaux.
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 personnaliser les paramètres de port du modem et des autres connexions COM.
Dans Tableau 2-9, remplacez les informations entre les chevrons par les valeurs
réelles.
Définitions d'objets Visual Basic
Propriétés CRemoteData
Tableau 2-9
Périphérique COM - Propriétés et paramètre
Propriété
Paramètre
Description
<CRemoteData>.ComParity(chaîne)
Chaîne
Définit la parité des communications.
Les valeurs suivantes sont valides :
<CRemoteData>.ComFlowControl(chaîne)
Chaîne
■
<Aucun>
■
Impaire
■
Paire
■
Marque
■
Espace
Définit le contrôle de flux des types de
connexion COM.
Les valeurs suivantes sont valides :
<CRemoteData>.ComStartedBy(chaîne)
Chaîne
■
<Aucune>
■
XONXOFF
■
RTS/CTS
■
Les deux
Définit le paramètre de début des types de
connexion COM.
Les valeurs suivantes sont valides :
<CRemoteData>.ComEndedBy(chaîne)
Chaîne
■
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
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)
27
28
Définitions d'objets Visual Basic
Propriétés CRemoteData
Propriété
Paramètre
Description
<CRemoteData>.ComSpeed(Long)
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 tableau suivant décrit les propriétés et les valeurs renvoyées par le périphérique
COM.
Dans Tableau 2-10, remplacez les informations entre les chevrons par les valeurs
réelles.
Tableau 2-10
Périphériques COM - Propriétés et valeurs renvoyées
Propriété
Valeur
renvoyée
Description
String = <CRemoteData>.ComParity
Chaîne
Renvoie l'une des valeurs suivantes comme
parité de communications :
String = <CRemoteData>.ComFlowControl
Chaîne
■
<Aucune>
■
Impaire
■
Paire
■
Marque
■
Espace
Renvoie le paramètre de contrôle de flux de
l'objet distant.
Les valeurs suivantes sont valides :
■
<Aucun>
■
XONXOFF
■
RTS/CTS
■
Les deux
Définitions d'objets Visual Basic
Propriétés CRemoteData
Propriété
Valeur
renvoyée
Description
String = <CRemoteData>.ComStartedBy
Chaîne
Renvoie le contrôle de début des types de
connexion COM.
Les valeurs suivantes sont valides :
String = <CRemoteData>.ComEndedBy
Chaîne
■
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 :
Long = <CRemoteData>.ComSpeed
Long
■
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 tableau suivant définit les propriétés et les paramètres d'un périphérique réseau
NetBIOS.
29
30
Définitions d'objets Visual Basic
Propriétés CRemoteData
Dans Tableau 2-11, remplacez les informations entre les chevrons par les valeurs
réelles.
Tableau 2-11
NetBIOS - Propriétés et paramètres
Propriété
Paramètre
Description
<CRemoteData>.LanaNumber(entier)
Entier
Définit le numéro d'adaptateur ré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 les valeurs
réelles.
Tableau 2-12
Propriété NetBIOS et valeur renvoyée
Propriété
Valeur
renvoyée
Description
Integer = <CRemoteData>.LanaNumber
Entier
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 les valeurs
réelles.
Tableau 2-13
RNIS via CAPI 2.0 - Propriétés et paramètres
Propriété
Paramètre
Description
<CRemoteData>.CapiChannelBonding(Bool)
Bool
Active ou désactive la liaison de canaux pour
les périphériques RNIS CAPI.
<CRemoteData>.CapiExtensions(chaîne)
Chaîne
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 les valeurs
réelles.
Définitions d'objets Visual Basic
objet CRemoteDataEx
Tableau 2-14
RNIS via CAPI 2.0 - Propriétés et valeurs renvoyées
Propriété
Valeur
renvoyée
Description
Bool= <CRemoteData>.CapiChannelBonding
Bool
Renvoie le paramètre de liaison de canaux
RNIS CAPI en cours dans l'objet distant.
String = <CRemoteData>.CapiExtensions
Chaîne
Renvoie la liste actuelle des extensions CAPI
à partir de l'objet distant.
objet CRemoteDataEx
L'objet CRemoteDataEx contient la même fonctionnalité que l'objet CRemoteData
avec une fonctionnalité supplémentaire.
Le tableau suivant décrit les propriétés et les paramètres.
Dans Tableau 2-15, remplacez les informations entre les chevrons par les valeurs
réelles.
Tableau 2-15
CRemoteDataEx - Paramètres
Propriété
Paramètre
Description
<CRemoteData>.PrivateKey (chaîne)
Chaîne
Définit le nom du conteneur de clé privée à
utiliser
<CRemoteData>.CertificateName(chaîne)
Chaîne
Définit le nom commun de la clé privée à
utiliser.
<CRemoteData>.AutoLoginPassword(octet)
Octet
Définit le niveau de chiffrement.
Les valeurs suivantes sont valides :
■
-1: Aucun
■
0: pcAnywhere
■
1: Symétrique
■
2: Clé publique
<CRemoteData>.DenyLowerEncrypt(Bool)
Bool
Définit si l'ordinateur distant autorise une
connexion à un ordinateur hôte utilisant un
niveau de chiffrement inférieur.
<CRemoteData>.AutoDomain(chaîne)
Chaîne
Définit le nom de domaine pour les connexions
automatiques. Cette option s'utilise avec les
types d'authentification NT et Windows.
31
32
Définitions d'objets Visual Basic
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 les valeurs
réelles.
Tableau 2-16
CRemoteDataEx - Propriétés et valeurs renvoyées
Propriété
Valeur
renvoyée
Description
String = <CRemoteData>.PrivateKey
Chaîne
Renvoie le nom du conteneur de clé privée
actuellement actif
String = <CRemoteData>.CertificateName
Chaîne
Renvoie le nom commun du conteneur de clé
privée actif.
Byte = <CRemoteData>.EncryptionLevel
Octet
Renvoie l'un des paramètres de chiffrement
suivants :
■
-1: Aucun
■
0: pcAnywhere
■
1: Symétrique
■
2: Clé publique
Bool = <CRemoteData>.DenyLowerEncrypt
Bool
Renvoie la valeur du paramètre de rejet de
niveau de chiffrement inférieur.
String = <CRemoteData>.AutoDomain
Chaîne
Renvoie le paramètre de nom de domaine 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)
Définitions d'objets Visual Basic
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)
''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
33
34
Définitions d'objets Visual Basic
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
Paramètre ou
valeur
renvoyés
Description
CurrentDirectory()
Valeur renvoyée Nom complet de chemin d'accès au dossier de
= chaîne
données pcAnywhere en cours dans lequel les
objets hôte pcAnywhere sont enregistrés.
Définitions d'objets Visual Basic
Méthodes CHostDataManager
Méthode
CHostDataManager
Paramètre ou
valeur
renvoyés
Description
FindFirst(schéma)
Paramètre =
schéma en tant
que chaîne
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).
FindFirst(nom)
Paramètre =
Nom comme
chaîne
Tampon de retour pour le chemin d'accès
complet du fichier d'objet hôte correspondant
au schéma spécifié.
FindFirst
Valeur renvoyée VRAI si un fichier d'objet hôte correspondant
= booléen
au schéma spécifié est trouvé. Le chemin
d'accès complet du fichier est stocké dans
Nom.
FindNext(nom)
Paramètre =
Nom comme
chaîne
FindNext
Valeur renvoyée VRAI si un autre fichier d'objet hôte
= booléen
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)
Paramètre =
Nom comme
chaîne
Nom intégralement qualifié du fichier d'objet
hôte à charger.
RetrieveObject(mode
d'accès)
Paramètre =
Mode d'accès
comme valeur
entière
Spécifie comment cet objet doit être utilisé.
Ce paramètre est lié à la protection par mot
de passe. Les options sont les suivantes :
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().
■
0 = Non spécifié
■
1 = Afficher uniquement
■
2 = Afficher et modifier
■
3 = Exécuter
RetrieveObject(mot de
passe)
Paramètre = Mot Mot de passe de l'objet. Peut être NULL.
de passe comme
chaîne
RetrieveObject
Valeur renvoyée Objet CHostData du fichier spécifié
= Objet
35
36
Définitions d'objets Visual Basic
Méthodes CHostDataManager
Méthode
CHostDataManager
Paramètre ou
valeur
renvoyés
Description
RetrieveObjectEx(nom)
Paramètre =
Nom comme
chaîne
Nom intégralement qualifié du fichier d'objet
hôte à charger.
RetrieveObjectEx(mode Paramètre =
d'accès)
Mode d'accès
comme valeur
entière
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
RetrieveObjectEx(mot de Paramètre = Mot Mot de passe de l'objet. Peut être NULL.
passe)
de passe comme
chaîne
RetrieveObjectEx
Valeur renvoyée Objet CHostDataEx du fichier spécifié
= Objet
CreateObject(nom)
Paramètre =
Nom comme
chaîne
CreateObject
Valeur renvoyée CHostData
= Objet
CreateObjectEx(nom)
Paramètre =
Nom comme
chaîne
CreateObjectEx
Valeur renvoyée CHostDataEx
= Objet
DeleteObject(nom)
Paramètre =
Nom comme
chaîne
DeleteObject(mot de
passe)
Paramètre = Mot Mot de passe de l'objet
de passe comme
chaîne
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.
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.
Nom intégralement qualifié du fichier d'objet
hôte de l'objet à supprimer.
Définitions d'objets Visual Basic
Propriétés CHostData
Méthode
CHostDataManager
Paramètre ou
valeur
renvoyés
Description
DeleteObject
Valeur renvoyée VRAI si l'objet est supprimé.
= booléen
Launch(nom)
Paramètre =
Nom comme
chaîne
Lancer
Valeur renvoyée VRAI si l'objet est lancé avec succès.
= booléen
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.
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 les valeurs
réelles.
Tableau 2-17
CHostData - Propriétés et paramètres
Propriété
Paramètre
Description
<CHostData>.PhoneNumber(chaîne)
Chaîne
Définit le numéro de téléphone de l'ordinateur
hôte.
<CHostData>.UseDialingProperties(Bool)
Bool
Définit les propriétés de numérotation du
système.
<CHostData>.RedialCount(entier)
Entier
Définit le nombre de tentatives de rappel avant
l'annulation de l'appel.
<CHostData>.RedialDelay(entier)
Entier
Définit le nombre de secondes d'attente entre
les tentatives de rappel.
<CHostData>.Password(chaîne)
Chaîne
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.
37
38
Définitions d'objets Visual Basic
Propriétés CHostData
Propriété
Paramètre
Description
<CHostData>.ExecuteProtection (Bool)
Bool
Définit la nécessité d'un mot de passe pour
exécuter l'objet. Définir par mot de passe.
<CHostData>.ReadProtection(Bool)
Bool
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.
<CHostData>.WriteProtection(Bool)
Bool
Définit l'obligation d'un mot de passe pour
enregistrer les modification de l'objet hôte.
Définir par mot de passe.
<CHostData>.LogSession (Bool)
Bool
Active et désactive la consignation des sessions
<CHostData>.RecordFile(chaîne)
Chaîne
Définit le nom et le chemin d'accès
intégralement qualifié du fichier
d'enregistrement de la session active.
<CHostData>.RecordSession(Bool)
Bool
Active et désactive la consignation
automatique de session.
<CHostData>.ReadObject(chaîne)
Chaîne
Définit le mot de passe de l'objet. Vous pouvez
utiliser cette propriété pour actualiser la copie
locale des données de l'objet hôte.
<CHostData>.WriteObject(chaîne)
Chaîne
Définit le mot de passe de l'objet. Utilisez cette
propriété pour créer l'objet hôte ou pour écrire
les changements apportés à celui-ci.
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 les valeurs
réelles.
Tableau 2-18
CHostData - Propriétés et valeurs renvoyées
Propriété
Valeur
renvoyée
Description
String = <CHostData>.PhoneNumber
Chaîne
Renvoie le numéro de téléphone de l'ordinateur
hôte
Bool = <CHostData>.UseDialingProperties
Bool
Renvoie l'utilisation des propriétés de
numérotation du système définies dans l'objet
hôte.
Integer = <CHostData>.RedialCount
Entier
Renvoie le nombre de tentatives d'appel défini
dans l'objet hôte.
Définitions d'objets Visual Basic
Propriétés CHostData
Propriété
Valeur
renvoyée
Description
Integer = <CHostData>.RedialDelay
Entier
Renvoie le nombre de secondes d'attente entre
les tentatives de rappel.
Bool = <CHostData>.ExecuteProtection
Bool
Renvoie la valeur du paramètre
ExecuteProtection.
Bool = <CHostData>.ReadProtection
Bool
Renvoie la valeur du paramètre
ReadProtection.
Bool = <CHostData>.WriteProtection
Bool
Renvoie la valeur du paramètre
WriteProtection.
Bool = <CHostData>.LogSession
Bool
VRAI si la consignation de session est activée.
String = <CHostData>.RecordFile
Chaîne
Renvoie le nom et le chemin d'accès
intégralement qualifié du fichier
d'enregistrement de la session.
Bool = <CHostData>.RecordSession
Bool
Renvoie la valeur du paramètre
d'enregistrement de session.
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 les valeurs
réelles.
39
40
Définitions d'objets Visual Basic
Propriétés CHostData
Tableau 2-19
Type de connexion - Propriétés et paramètres
Propriété
Paramètre
Description
<CHostData>.ConnectionType(chaîne)
Chaîne
Définit le type de connexion de l'hôte. 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)
<CHostData>.AssignConnection(chaîne)
Chaîne
Définit le type de connexion présent dans la
chaîne sur l'état actif.
<CHostData>.UnassignConnection(chaîne)
Chaîne
Définit le type de connexion présent dans la
chaîne sur l'état inactif.
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 les valeurs
réelles.
Tableau 2-20
Type de connexion - Propriétés et valeurs renvoyées
Propriété
Valeur
renvoyée
Description
String = <CHostData>.ConnectionTypes
Chaîne
Renvoie le type de connexion de l'objet hôte.
Définitions d'objets Visual Basic
Propriétés CHostData
Propriété
Valeur
renvoyée
Description
Integer = <CHostData>.ConnectionType
Entier
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)
String = <CHostData>.FirstConnectionType
Chaîne
Renvoie le premier type de connexion
disponible.
String = <CHostData>.NextConnectionType
Chaîne
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.
Bool = <CHostData>.FindConnectionType(type de Bool
connexion)
VRAI si le type de connexion indiqué a été
trouvé dans la liste des types de connexion
disponibles.
Integer = <CHostData>.MaxAssignedConnections Entier
Renvoie le nombre maximum de types de
connexion qui peuvent être actifs sur cet hôte.
String = <CHostData>.FirstAssignedConnection
Chaîne
Renvoie le premier type de connexion actif
affecté.
String = <CHostData>.NextAssignedConnection
Chaîne
Renvoie le type de connexion actif affecté
suivant.
Bool = <CHostData>.FindAssignedConnection(type Bool
de connexion)
VRAI si le type de connexion transmis
correspond à l'un des types de connexion
actifs.
41
42
Définitions d'objets Visual Basic
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 le type 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é. Il est normal d'appeler la méthode AssignConnection sur le 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 objet hôte pcAnywhere peut prendre en charge jusqu'à deux types de connexion
affectés. La mé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 :
Paramètre
Description
Type de connexion Nom d'un type de périphérique de connexion à affecter.
comme chaîne
Le tableau suivant définit la valeur renvoyée pour AssignConnection :
Valeur renvoyée Description
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 :
Paramètre
Description
Type de connexion Nom d'un type de périphérique de connexion à désaffecter.
comme chaîne
Définitions d'objets Visual Basic
Propriétés CHostData
Le tableau suivant définit la valeur renvoyée pour UnassignConnection :
Valeur renvoyée Description
Booléenne
VRAI si ce type de périphérique est désaffecté avec succès.
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 les valeurs
réelles.
Tableau 2-21
Propriétés de numérotation - Propriétés et paramètres
Propriété
Paramètre
Description
<CHostData>.AreaCode(chaîne)
Chaîne
Définit le code de zone pour les connexions
par modem
<CHostData>.CountryCode(chaîne)
Chaîne
Définit l'indicatif international pour les
connexions par modem
Le tableau suivant définit les propriétés et les valeurs renvoyées pour les propriétés
de numérotation par modem.
Dans Tableau 2-22, remplacez les informations entre les chevrons par les valeurs
réelles.
Tableau 2-22
Propriétés de numérotation par modem - Propriétés et valeurs
renvoyées
Propriété
Valeur
renvoyée
Description
String = <CHostData>.AreaCode
Chaîne
Renvoie le code de zone
String = <CHostData>.CountryCode
Chaîne
Renvoie l'indicatif international.
Integer = <CHostData>.CountryCodes
Entier
Renvoie le nombre d'indicatifs internationaux
disponibles.
String= <CHostData>.FirstCountryCode
Chaîne
Renvoie le premier indicatif de pays
apparaissant dans la liste du système
d'exploitation.
43
44
Définitions d'objets Visual Basic
Propriétés CHostData
Propriété
Valeur
renvoyée
Description
String = <CHostData>.NextCountryCode
Chaîne
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.
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 personnaliser les paramètres de port du modem et des autres connexions COM.
Dans Tableau 2-23, remplacez les informations entre les chevrons par les valeurs
réelles.
Tableau 2-23
Périphérique COM - Propriétés et paramètre
Propriété
Paramètre
Description
<CHostData>.ComParity (chaîne)
Chaîne
Définit la parité des communications.
Les valeurs suivantes sont valides :
<CHostData>.ComFlowControl (chaîne)
Chaîne
■
<Aucune>
■
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éfinitions d'objets Visual Basic
Propriétés CHostData
Propriété
Paramètre
Description
<CHostData>.ComStartedBy(chaîne)
Chaîne
Définit le paramètre de début des types de
connexion COM.
Les valeurs suivantes sont valides :
<CHostData>.ComEndedBy(chaîne)
Chaîne
■
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
Définit le paramètre de fin des types de
connexion COM.
Les valeurs suivantes sont valides :
<CHostData>.ComSpeed(Long)
Long
■
Toujours connecté
■
Détection de porteuse (DCD)
■
Prêt à émettre (CTS)
■
Ensemble de données prêt (DSR)
■
Signal de sonnerie (RI)
Définit la vitesse COM maximale
Les valeurs suivantes sont valides :
■
110
■
300
■
600
■
1200
■
2400
■
4800
■
9600
■
38400
■
57600
■
115200
Le tableau suivant décrit les propriétés et les valeurs renvoyées par le périphérique
COM.
Dans Tableau 2-24, remplacez les informations entre les chevrons par les valeurs
réelles.
45
46
Définitions d'objets Visual Basic
Propriétés CHostData
Tableau 2-24
Périphériques COM - Propriétés et valeurs renvoyées
Propriété
Valeur
renvoyée
Description
String = <CHostData>.ComParity
Chaîne
Renvoie l'une des valeurs suivantes comme
parité de communications :
String = <CHostData>.ComFlowControl
Chaîne
■
<Aucune>
■
Impaire
■
Paire
■
Marque
■
Espace
Renvoie le paramètre de contrôle de flux de
l'objet hôte.
Les valeurs suivantes sont valides :
String = <CHostData>.ComStartedBy
Chaîne
■
<Aucun>
■
XONXOFF
■
RTS/CTS
■
Les deux
Renvoie le contrôle de début des types de
connexion COM.
Les valeurs suivantes sont valides :
String = <CHostData>.ComEndedBy
Chaîne
■
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)
Définitions d'objets Visual Basic
Propriétés CHostData
Propriété
Valeur
renvoyée
Description
Long = <CHostData>.ComSpeed
Long
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és de périphérique NetBIOS
Le tableau suivant définit les propriétés et les paramètres d'un périphérique réseau
NetBIOS.
Dans Tableau 2-25, remplacez les informations entre les chevrons par les valeurs
réelles.
Tableau 2-25
NetBIOS - Propriétés et paramètres
Propriété
Paramètre
Description
<CHostData>.LanaNumber(entier)
Entier
Définit le numéro d'adaptateur ré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 les valeurs
réelles.
Tableau 2-26
Valeurs NetBIOS renvoyées
Propriété
Valeur
renvoyée
Description
Integer = <CHostData>.LanaNumber
Entier
Renvoie le paramètre en cours du numéro
LANA pour les connexions NetBIOS.
47
48
Définitions d'objets Visual Basic
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 les valeurs
réelles.
Tableau 2-27
RNIS via CAPI 2.0 - Propriétés et paramètres
Propriété
Paramètre
Description
<CHostData>.CapiChannelBonding(Bool)
Bool
Active ou désactive la liaison de canaux pour
les périphériques RNIS CAPI.
<CHostData>.CapiExtensions(chaîne)
Chaîne
Définit toute extension CAPI supplémentaire
nécessaire pour les communications.
Le Tableau 2-28 définit les propriétés et les valeurs renvoyées pour les connexions
RNIS européennes.
Tableau 2-28
RNIS via CAPI 2.0 - Propriétés et valeurs renvoyées
Propriété
Valeur
renvoyée
Description
Bool= <CHostData>.CapiChannelBonding
Bool
Renvoie le paramètre de liaison de canaux
RNIS CAPI en cours dans l'objet hôte.
String = <CHostData>.CapiExtensions
Chaîne
Renvoie la liste actuelle des extensions CAPI
à partir de l'objet hôte.
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 les valeurs
réelles.
Tableau 2-29
CHostDataEx - Propriétés et paramètres
Propriété
Paramètre
Description
<CHostData>.CryptPrivateKey (chaîne)
Chaîne
Définit le nom du conteneur de clé privée à
utiliser
Définitions d'objets Visual Basic
objet CHostDataEx
Propriété
Paramètre
Description
<CHostData>.CryptCommonName (chaîne)
Chaîne
Définit le nom commun de la clé privée à
utiliser.
<CHostData>.CryptReqLevel(Octet)
Octet
Définit le niveau de chiffrement.
Les valeurs suivantes sont valides :
■
-1: Aucun
■
0: pcAnywhere
■
1: Symétrique
■
2: Clé publique
<CHostData>.CryptRefuseLower(Bool)
Bool
Définit si l'ordinateur hôte accepte une
connexion d'un ordinateur distant utilisant un
niveau de chiffrement inférieur.
<CHostData>.CallersPath(chaîne)
Chaîne
Définit le chemin d'accès intégralement
qualifié des fichiers d'appelant.
<CHostData>.ConfirmConnect(Bool)
Bool
Définit si un message demandera à l'utilisateur
hôte de confirmer les connexions.
<CHostData>.ConfirmTimeout(Octet)
Octet
Définit le nombre de secondes de délai pour
confirmer la connexion.
<CHostData>.ConfirmDeny(Bool)
Bool
Définit si la connexion doit se terminer lorsque
le délai de confirmation de la connexion expire.
<CHostData>.PwCaseSensitive(Bool)
Bool
Impose l'utilisation de mots de passe sensibles
à la casse.
<CHostData>.PwAttempts(Octet)
Octet
Définit le nombre d'échecs d'ouverture de
session consécutifs autorisés avant l'abandon
de la connexion.
<CHostData>.PwTimeout(Octet)
Octet
Définit le nombre de minutes dont dispose
l'utilisateur pour ouvrir une session avant
l'abandon de la connexion.
<CHostData>.ActiveKbds(Octet)
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
49
50
Définitions d'objets Visual Basic
objet CHostDataEx
Propriété
Paramètre
Description
<CHostData>.InactiveTimeout(Octet)
Octet
Définit le nombre de minutes pendant lequel
le clavier et la souris peuvent rester inactifs
avant l'abandon de la connexion.
<CHostData>.LockSystemWhileWait(Bool)
Bool
Définit le verrouillage de l'ordinateur hôte lors
du démarrage.
<CHostData>.MinimizeOnLaunch(Bool)
Bool
Définit l'option de démarrage de l'hôte en
réduction.
<CHostData>.RunAsService(Bool)
Bool
Active le fonctionnement de l'hôte comme
service.
<CHostData>.ConnLostWait(Octet)
Octet
Définit le nombre de minutes d'attente avant
d'autoriser un autre appelant à se connecter.
<CHostData>.ConnLostHostOpts(Bool)
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 :
<CHostData>.EnableConnLostSecurity(Bool)
Bool
■
FAUX : Attente de la connexion suivante
■
VRAI : Annulation de l'hôte
Active ou désactive les options de sécurité de
fin de session pour les sessions qui se
terminent de façon anormale.
Définitions d'objets Visual Basic
objet CHostDataEx
Propriété
Paramètre
Description
<CHostData>.AuthenticationType(octet)
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 pcAnywhere est utilisée par
défaut si aucune valeur d'authentification n'est
définie ou si la valeur définie n'est pas valide
(par exemple, si le type d'authentification n'est
pas disponible).
<CHostData>.ConnLostSecurity(octet)
Octet
Définit les options de sécurité pour traiter une
fin de session anormale.
Les valeurs suivantes sont valides :
■
1: Déconnecter l'utilisateur
■
2: Redémarrer l'ordinateur hôte
■
3: Verrouiller l'ordinateur
<CHostData>.CallbkDelay(octet)
Octet
Définit le nombre de secondes d'attente avant
que le modem hôte ne rappelle l'ordinateur
distant.
<CHostData>.EndSessHostOpts(Bool)
Bool
Définit si l'hôte attend une autre connexion ou
est annulé après la fin normale de la session.
Les valeurs suivantes sont valides :
<CHostData>.EnableEndSessSecurity(Bool)
Bool
■
FAUX : Attente de la connexion suivante
■
VRAI : Annulation de l'hôte
Active ou désactive les options de sécurité pour
une fin de session normale.
51
52
Définitions d'objets Visual Basic
objet CHostDataEx
Propriété
Paramètre
Description
<CHostData>.EndSessSecurity(octet)
Octet
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 hôte
■
3: Verrouiller l'ordinateur
<CHostData>.BlankHost(Bool)
Bool
Définit l'effacement de l'écran de l'ordinateur
hôte. Certaines cartes d'affichage ne prennent
pas en charge cette fonction.
<CHostData>.AllowRemoteMouse(Bool)
Bool
Désactive l'utilisation de la souris sur
l'ordinateur distant pendant une session.
<CHostData>.RebootOnDisconnect(Bool)
Bool
Si VRAI, force l'ordinateur à redémarrer après
toute fin de session.
<CHostData>.PasswordAfterDisc(Bool)
Bool
Déconnecte l'utilisateur lorsque la session se
termine.
<CHostData>.LogFailures(Bool)
Bool
Consigne les tentatives de mot de passe qui
ont échoué.
<CHostData>.AllowDriveSecurity(Bool)
Bool
Active les options de sécurité de lecteur. Ce
paramètre n'est valide que sur les systèmes de
fichiers NTFS.
<CHostData>.UseDirectoryServices(Bool)
Bool
Active l'utilisation des services d'annuaire pour
l'authentification.
<CHostData>.DirectoryServiceEntry(chaîne)
Chaîne
Définit les paramètres des services d'annuaire.
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 les valeurs
réelles.
Tableau 2-30
CHostDataEx - Propriétés et valeurs renvoyées
Propriété
Valeur
renvoyée
Description
String = <CHostDataEx>.CryptPrivateKey
Chaîne
Renvoie le nom du conteneur de clé privée
actuellement actif.
Définitions d'objets Visual Basic
objet CHostDataEx
Propriété
Valeur
renvoyée
Description
String = <CHostDataEx>.CryptCommonName
Chaîne
Renvoie le nom commun du conteneur de clé
privée actif.
Byte = <CHostDataEx>.CryptReqLevel
Octet
Renvoie l'un des paramètres de chiffrement
suivants :
■
-1: Aucun
■
0: pcAnywhere
■
1: Symétrique
■
2: Clé publique
Bool = <CHostDataEx>.CryptRefuseLower
Bool
Renvoie la valeur du paramètre de rejet de
niveau de chiffrement inférieur.
String = <CHostDataEx>.CallersPath
Chaîne
Renvoie le chemin d'accès intégralement
qualifié des fichiers d'appelant.
Bool = <CHostDataEx>.ConfirmConnect
Bool
Renvoie la valeur du paramètre de
confirmation de connexion.
Byte = <CHostDataEx>.ConfirmTimeout
Octet
Renvoie la valeur du paramètre de rejet de
niveau de chiffrement inférieur.
Bool = <CHostDataEx>.ConfirmDeny
Bool
Renvoie la valeur du paramètre de
déconnexion sur délai dépassé.
Bool = <CHostDataEx>.PwCaseSensitive
Bool
Renvoie la valeur du paramètre de mot de
passe sensible à la casse.
Byte = <CHostDataEx>.PwAttempts
Octet
Renvoie la valeur du paramètre de nombre
limite de tentatives d'ouverture de session par
appel.
Byte = <CHostDataEx>.PwTimeout
Octet
Renvoie la valeur du paramètre de délai limite
d'ouverture de session (en minutes).
Byte = <CHostDataEx>.ActiveKbds
Octet
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
53
54
Définitions d'objets Visual Basic
objet CHostDataEx
Propriété
Valeur
renvoyée
Description
Byte = <CHostDataEx>. InactiveTimeout
Octet
Renvoie le nombre de minutes d'attente avant
déconnexion si la limite d'inactivité est
atteinte.
Bool = <CHostDataEx>.LockSystemWhileWait
Bool
Renvoie le paramètre de verrouillage de
l'ordinateur hôte au démarrage.
Bool = <CHostDataEx>.MinimizeOnLaunch
Bool
Renvoie le paramètre de démarrage de l'hôte
en réduction.
Bool = <CHostDataEx>.RunAsService
Bool
Renvoie le paramètre de fonctionnement de
l'hôte comme service.
Byte = <CHostDataEx>.ConnLostWait
Octet
Renvoie le nombre de minutes d'attente avant
d'autoriser un autre appelant à se connecter.
Bool = <CHostDataEx>.ConnLostHostOpts
Bool
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 :
Bool = <CHostDataEx>.ConnLostWait
Bool
■
FAUX : Attente de la connexion suivante
■
VRAI : Annulation de l'hôte
Renvoie la valeur de l'option de sécurité définie
pour traiter une fin de session anormale.
Définitions d'objets Visual Basic
objet CHostDataEx
Propriété
Valeur
renvoyée
Description
Byte = <CHostDataEx>.AuthenticationType
Octet
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 pcAnywhere est utilisée par
défaut si aucune valeur d'authentification n'est
définie ou si la valeur définie n'est pas valide
(par exemple, si le type d'authentification n'est
pas disponible).
Byte = <CHostDataEx>.ConnLostSecurity
Octet
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 hôte
■
3: Verrouiller l'ordinateur
Byte = <CHostDataEx>.CallbkDelay
Octet
Renvoie le nombre de secondes d'attente avant
que le modem hôte ne rappelle l'ordinateur
distant.
Bool = <CHostDataEx>.EndSessHostOpts
Bool
Renvoie le paramètre déterminant si l'hôte
attend une autre connexion ou est annulé après
une fin de session normale.
Les valeurs suivantes sont valides :
■
FAUX : Attente de la connexion suivante
■
VRAI : Annulation de l'hôte
55
56
Définitions d'objets Visual Basic
objet CHostDataEx
Propriété
Valeur
renvoyée
Description
Bool = <CHostDataEx>.EnableEndSessSecurity
Bool
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.
Byte = <CHostDataEx>.EndSessSecurity
Octet
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 hôte
■
3: Verrouiller l'ordinateur
Bool = <CHostDataEx>.BlankHost
Bool
Renvoie l'option définie pour l'effacement de
l'écran.
Bool = <CHostDataEx>.AllowRemoteMouse
Bool
Renvoie l'option déterminant si l'utilisateur
distant dispose du contrôle du clavier et de la
souris au cours d'une session.
Bool = <CHostDataEx>.RebootOnDisconnect
Bool
Renvoie l'option déterminant si l'ordinateur
hôte redémarre après la fin de la session.
Bool = <CHostDataEx>.PasswordAfterDisc
Bool
Renvoie l'option déterminant si l'hôte est
déconnecté après la fin de la session.
Bool = <CHostDataEx>.LogFailures
Bool
Renvoie l'option déterminant si les échecs de
mots de passe sont consignés.
Bool = <CHostDataEx>.AllowDriveSecurity
Bool
Renvoie l'option déterminant si la sécurité du
lecteur est activée.
Bool = <CHostDataEx>.UseDirectoryServices
Bool
Renvoie l'option déterminant si les services
d'annuaire sont activés.
String = <CHostDataEx>.DirectoryServiceEntry
Chaîne
Renvoie les paramètres de services d'annuaire.
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
Définitions d'objets Visual Basic
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"
''é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")
57
58
Définitions d'objets Visual Basic
fonctions awrem32
HostDataManager.ChangeDirectory ("C:\dev\bin.w32\data")
HostDataManager.FindFirst "*", s
MsgBox (s)
HostDataManager.FindNext s
MsgBox (s)
End Sub
fonctions awrem32
Les fonctions Awrem32 fournissent des paramètres et renvoient des valeurs pour
la gestion des connexions entre l'ordinateur hôte et l'ordinateur distant.
fonction awrem32
Paramètre ou
valeur
renvoyés
awConnect(nom de fichier) Paramètre =
Nom comme
chaîne
Description
Nom intégralement qualifié du fichier .chf
contenant les informations sur
l'ordinateur hôte.
awConnect
Valeur renvoyée VRAI si la commande est exécutée.
= booléen
awDisconnect()
Valeur renvoyée Après avoir appelé cette fonction, le
= booléen
programme appelant doit supprimer
l'objet (C++ - delete IAwrem32X*, VB – set
ObjectName = Nothing;)
FileXferFromHost(HostFile) Paramètre =
Contient le chemin d'accès intégralement
HostFile comme qualifié du fichier à copier à partir de
chaîne
l'ordinateur hôte.
FileXferFromHost(RemoteFile) Paramètre =
RemoteFile
comme chaîne
FileXferFromHost
Contient le chemin d'accès de destination,
intégralement qualifié. Les chaînes de
fichier hôte et de fichier distant ne sont
pas obligatoirement identiques.
Valeur renvoyée VRAI si la commande est exécutée.
= booléen
Définitions d'objets Visual Basic
fonctions awrem32
fonction awrem32
Paramètre ou
valeur
renvoyés
Description
FileXferToHost(HostFile)
Paramètre =
Copie un fichier de l'ordinateur distant
HostFile comme vers l'ordinateur hôte. Les paramètres
chaîne
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.
FileXferToHost(RemoteFile) Paramètre =
RemoteFile
comme chaîne
Contient le chemin 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.
CreateFolderOnHost(nom
de répertoire)
Paramètre =
FolderName
comme chaîne
Contient le lecteur et le chemin d'accès du
dossier sur l'ordinateur hôte.
CreateFolderOnHost
Valeur renvoyée VRAI si la commande est exécutée.
= booléen
ExecuteHostFile(nom de
fichier)
Paramètre =
Nom de fichier
comme chaîne
Exécute un fichier existant sur
l'ordinateur hôte. Cette fonction ne 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, cette fonction n'ouvre pas
Microsoft Word si vous exécutez un fichier
.doc.
Le paramètre contient le chemin d'accès
intégralement qualifié du fichier sur
l'ordinateur hôte.
ExecuteHostFile
Valeur renvoyée VRAI si la commande est exécutée.
= booléen
GetError()
Valeur renvoyée Renvoie la dernière erreur générée dans
= Chaîne
Awrem32.
59
60
Définitions d'objets Visual Basic
fonctions awrem32
fonction awrem32
Paramètre ou
valeur
renvoyés
Description
ConnectionStatus()
Valeur retournée Renvoie l'état courant de la connexion à
= Court
l'ordinateur hôte.
Les valeurs possibles sont les suivantes :
■
-1 = Connexion perdue
■
0 = Aucune connexion
■
1 = Session connectée
Chapitre
3
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
■
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
Contient les informations nécessaires pour se connecter au serveur
d'automatisation pcAnywhere et accéder à ses interfaces.
Awrem32
Contient les informations nécessaires au contrôle des connexions
pcAnywhere.
Les objets décrits dans le Tableau 3-1 composent Winawsvr.
62
Définitions d'objets Visual C++
Méthodes CRemoteDataManager
Tableau 3-1
Objets Winawsvr
Objet
Description
Référence
CRemoteDataManager
Fournit les méthodes pour créer, ouvrir,
modifier, enregistrer et supprimer les
objets CRemoteData.
Se reporter à "Méthodes
CRemoteDataManager" à la page 62.
CRemoteData
Définit les paramètres permettant
d'accéder à la fonction distant de
pcAnywhere et de la contrôler.
Se reporter à "objet CRemoteData"
à la page 66.
CHostDataManager
Fournit les méthodes pour créer, ouvrir,
modifier, enregistrer et supprimer les
objets ChostData.
Se reporter à "Méthodes
CHostDataManager" à la page 73.
CHostData
Définit les paramètres permettant
Se reporter à "objet CRemoteData"
d'accéder à la fonction hôte de pcAnywhere à la page 66.
et de la contrôler.
Se reporter à "objet CRemoteDataEx"
à la page 72.
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
Paramètre ou
Description
valeur renvoyés
BSTR CurrentDirectory();
Paramètre =
BSTR
Nom complet de chemin d'accès au
dossier de données pcAnywhere en cours
dans lequel les objets distants sont
enregistrés.
Définitions d'objets Visual C++
Méthodes CRemoteDataManager
Méthode
Paramètre ou
Description
valeur renvoyés
BOOL
ChangeDirectory(LPCTSTR
lpszNewDirectory);
Paramètre =
Change le dossier actuel dans lequel les
LPCTSTR
objets distants pcAnywhere sont stockés.
lpszNewDirectory Le paramètre est le nom d'un dossier
existant.
Valeur renvoyée
= booléen
La valeur retournée est VRAIE en cas de
succès.
BOOL FindFirst(LPCTSTR
lpszPattern, BSTR FAR* );
Paramètre =
LPCTSTR
lpszPattern
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).
BOOL
Parameter =
Tampon de retour pour le chemin d'accès
FindFirst(pbstrFullQualName); BSTR FAR *
complet du fichier d'objet distant
pbstrFullQualName correspondant au schéma spécifié.
BOOL FindFirst
Valeur renvoyée
= booléen
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.
BOOL FindNext(BSTR FAR*
pbstrFullQualName);
Parameter =
Après l'appel réussi de FindFirst() pour
BSTR FAR *
obtenir le nom d'un fichier d'objet
pbstrFullQualName distant dans le dossier en cours,
FindNext() peut être appelé pour trouver
Valeur renvoyée
le fichier suivant correspondant au
= booléen
schéma.
Renvoie la valeur 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
pbstrFullQualName.
LPDISPATCH
RetrieveObject(LPCTSTR
lpszFQName);
Parameter =
LPCTSTR
lpszFQName
Récupère un objet CRemoteData par nom
de fichier.
Le paramètre est le nom intégralement
qualifié du fichier d'objet distant à
charger.
63
64
Définitions d'objets Visual C++
Méthodes CRemoteDataManager
Méthode
Paramètre ou
Description
valeur renvoyés
LPDISPATCH
RetrieveObject(short
wAccessMode);
Parameter =
short
wAccessMode
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
LPDISPATCH
RetrieveObject(LPCTSTR
lpszPassword);
Parameter =
LPCTSTR
lpszPassword
Mot de passe de l'objet. Peut être NULL.
LPDISPATCH
RetrieveObjectEx(LPCTSTR
lpszFQName);
Parameter =
LPCTSTR
lpszFQName
Récupère un objet CRemoteDataEx par
nom de fichier.
LPDISPATCH
RetrieveObjectEx(short
wAccessMode);
Parameter =
short
wAccessMode
Spécifie comment cet objet doit être
utilisé. Ce paramètre est lié à la
protection par mot de passe. Les options
sont les suivantes :
Le paramètre est le nom intégralement
qualifié du fichier d'objet distant à
charger.
■
0 = Non spécifié
■
1 = Afficher uniquement
■
2 = Afficher et modifier
■
3 = Exécuter
LPDISPATCH
RetrieveObjectEx(LPCTSTR
lpszPassword);
Parameter =
LPCTSTR
lpszPassword
Mot de passe de l'objet. Peut être NULL.
LPDISPATCH
RetrieveObjectEx
Valeur renvoyée
= LPDISPATCH
Pointeur sur un objet envoi OLE. L'objet
est un objet CRemoteDataEx.
Voir Exemple de code Visual C++ pour
la fonctionnalité du distant.
Définitions d'objets Visual C++
Méthodes CRemoteDataManager
Méthode
Paramètre ou
Description
valeur renvoyés
LPDISPATCH
CreateObject(LPCTSTR
lpszFQName);
Parameter =
LPCTSTR
lpszFQName
Valeur renvoyée
= LPDISPATCH
Crée un objet CRemoteData 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.
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.
LPDISPATCH
CreateObjectEx(LPCTSTR
lpszFQName);
Parameter =
LPCTSTR
lpszFQName
Valeur renvoyée
= LPDISPATCH
Crée un objet CRemoteDataEx 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.
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 Parameter =
lpszFQName);
LPCTSTR
lpszFQName
Supprime un fichier d'objet distant.
BOOL DeleteObject(LPCTSTR Parameter =
lpszPassword);
LPCTSTR
lpszPassword
Mot de passe de l'objet. Peut être NULL.
BOOL DeleteObject
BOOL
VRAI si l'objet est supprimé.
BOOL Launch(LPCTSTR
lpszFQName);
Parameter =
LPCTSTR
lpszFQName
Lance un fichier d'objet distant, ce qui
ouvre la fenêtre de terminal distant
pcAnywhere.
Valeur renvoyée
= booléen
Le paramètre est le fichier intégralement
qualifié d'objet distant de l'objet à lancer.
Le paramètre est le nom intégralement
qualifié du fichier d'objet distant de
l'objet à supprimer.
La valeur renvoyée est VRAI si l'objet est
lancé avec succès.
65
66
Définitions d'objets Visual C++
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éro de téléphone est le numéro à composer pour établir une connexion par
modem avec un ordinateur hôte pcAnywhere.
BSTR GetPhoneNumber();
void SetPhoneNumber(LPCTSTR lpszNewValue);
Indique si des propriétés de 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 les propriétés de numérotation sont utilisées, il s'agit du code de 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.
Définitions d'objets Visual C++
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);
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);
67
68
Définitions d'objets Visual C++
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 TAPI utilise le premier périphérique TAPI trouvé dans le 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 types de connexion suivants 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 :
Définitions d'objets Visual C++
objet CRemoteData
■
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.
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)
69
70
Définitions d'objets Visual C++
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 la liaison de canaux (utilise deux canaux RNIS pour une connexion) si VRAI.
BOOL GetCapiChannelBonding();
void SetCapiChannelBonding(BOOL bNewValue);
Définit toute extension CAPI supplémentaire nécessaire pour les communications.
BSTR GetCapiExtensions();
void SetCapiExtensions(LPCTSTR lpszNewValue);
Définitions d'objets Visual C++
objet CRemoteData
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).
Méthode
Paramètre ou
Description
valeur renvoyés
short ConnectionTypes();
Valeur retournée
= Court
BSTR
FirstConnectionType(); et
BSTR
NextConnectionType();
Valeur renvoyée = FirstConnectionType() et
BSTR
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és peuvent être utilisés
avec la fonction SetConnectionType().
Nombre de types de connexion
disponibles sur cet ordinateur
La valeur renvoyée est le nom d'un type
de périphérique de connexion pris en
charge.
BOOL
Paramètre =
Nom d'un type de périphérique de
FindConnectionType(LPCTSTR LPCTSTR
connexion.
lpszConnectionType);
lpszConnectionTyp
La valeur renvoyée est VRAI si le type de
Valeur renvoyée = connexion transmis existe sur
booléen
l'ordinateur.
short CountryCodes();
Valeur retournée
= Court
Renvoie le nombre d'indicatifs
internationaux disponibles.
BSTR FirstCountryCode(); et Valeur renvoyée = FirstCountryCode() et NextCountryCode()
BSTR NextCountryCode(); BSTR
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'indicatif international ou chaîne
suivante.
71
72
Définitions d'objets Visual C++
objet CRemoteDataEx
Méthode
Paramètre ou
Description
valeur renvoyés
BOOL ReadObject(LPCTSTR Paramètre =
lpszPassword);
LPCTSTR
lpszPassword
Lit les données d'objet du fichier d'objet
distant.
BOOL WriteObject(LPCTSTR Paramètre =
lpszPassword);
LPCTSTR
lpszPassword
Ecrit les données d'objet dans le fichier
d'objet distant.
Le paramètre est le mot de passe objet
Valeur renvoyée =
La valeur renvoyée est VRAI si l'objet est
booléen
lancé avec succès.
Le paramètre est le mot de passe objet
Valeur renvoyée =
La valeur renvoyée est VRAI si l'objet est
booléen
lancé avec succès.
objet CRemoteDataEx
L'objet CRemoteDataEx contient la même fonction que l'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);
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 sur TCP/IP, définit le nom de l'ordinateur sur l'adresse TCP/IP transmise
dans la fonction, puis lance l'objet distant.
BOOL LaunchTCPRemote(LPCTSTR lpszAddress)
{
BOOL bReturn = FALSE;
Définitions d'objets Visual C++
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);
//
if
{
//
if
Enregistrer les données de l'objet
(remoteData.WriteObject(0))
Et le lancer
(remoteData.Launch())
bReturn = TRUE;
}
// Libérer l'objet distant.
remoteData.ReleaseDispatch();
remoteDM.ReleaseDispatch( _T( "WINAWSVR.RemoteDataManager") );
return bReturn;
}
Méthodes CHostDataManager
Le table suivant décrit les méthodes CHostDataManager, y compris les paramètres
et les valeurs renvoyées pour accéder aux objets CHostData et les contrôler :
73
74
Définitions d'objets Visual C++
Méthodes CHostDataManager
Méthode
Paramètre ou
valeur renvoyés
Description
BSTR CurrentDirectory();
Valeur renvoyée =
BSTR
Renvoie le chemin d'accès complet du
répertoire en cours dans lequel les
objets hôte de pcAnywhere sont stockés.
BOOL
Paramètre =
ChangeDirectory(LPCTSTR LPCTSTR
lpszNewDirectory);
lpszNewDirectory
Change le dossier en cours dans lequel
les objets hôte de pcAnywhere sont
stockés.
Valeur renvoyée =
booléen
Le paramètre est le nom d'un dossier
existant.
La valeur renvoyée est VRAI en cas de
succès.
BOOL FindFirst(LPCTSTR Paramètre =
lpszPattern);
LPCTSTR
lpszPattern
Valeur renvoyée =
booléen
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 [*] trouve tous les fichiers
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
Parameter = BSTR Tampon de retour pour le chemin
FAR* pbstrFullQualName); FAR *
d'accès complet du fichier d'objet
pbstrFullQualName 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.
Définitions d'objets Visual C++
Méthodes CHostDataManager
Méthode
Paramètre ou
valeur renvoyés
Description
BOOL FindNext(BSTR
Parameter = BSTR Après l'appel réussi de FindFirst() pour
FAR* pbstrFullQualName); FAR *
obtenir le nom d'un fichier d'objet hôte
pbstrFullQualName dans le dossier en cours, FindNext() peut
être appelé pour trouver le fichier
Valeur renvoyée =
suivant correspondant au schéma.
booléen
Le paramètr est le 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().
Renvoie la valeur 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
pbstrFullQualName.
LPDISPATCH
RetrieveObject(LPCTSTR
lpszFQName);
Parameter =
LPCTSTR
lpszFQName
Récupère un objet CHostData par nom
de fichier.
LPDISPATCH
RetrieveObject(short
wAccessMode);
Parameter = short
wAccessMode
Spécifie comment cet objet doit être
utilisé. Ce paramètre est lié à la
protection par mot de passe. Les options
sont les suivantes :
Le paramètre est le nom intégralement
qualifié du fichier d'objet hôte à charger.
■
0 = Non spécifié
■
1 = Afficher uniquement
■
2 = Afficher et modifier
■
3 = Exécuter
LPDISPATCH
RetrieveObject(LPCTSTR
lpszPassword);
Parameter =
LPCTSTR
lpszPassword
Mot de passe de l'objet. Peut être NULL.
LPDISPATCH
RetrieveObject
Valeur renvoyée =
LPDISPATCH
Pointeur sur un objet envoi OLE. L'objet
est un objet CHostData.
Voir Exemple de code Visual C++ pour
la fonctionnalité Hôte.
75
76
Définitions d'objets Visual C++
Méthodes CHostDataManager
Méthode
Paramètre ou
valeur renvoyés
Description
LPDISPATCH
Parameter =
RetrieveObjectEx(LPCTSTR LPCTSTR
lpszFQName);
lpszFQName
Récupère un objet CHostDataEx par
nom de fichier.
LPDISPATCH
RetrieveObjectEx(short
wAccessMode);
Spécifie comment cet objet doit être
utilisé. Ce paramètre est lié à la
protection par mot de passe. Les options
sont les suivantes :
Parameter = short
wAccessMode
Le paramètre est le nom intégralement
qualifié du fichier d'objet hôte à charger.
■
0 = Non spécifié
■
1 = Afficher uniquement
■
2 = Afficher et modifier
■
3 = Exécuter
LPDISPATCH
Parameter =
RetrieveObjectEx(LPCTSTR LPCTSTR
lpszPassword);
lpszPassword
Mot de passe de l'objet. Peut être NULL.
LPDISPATCH
RetrieveObjectEx
Pointeur sur un objet envoi OLE. L'objet
est un objet CHostDataEx.
Valeur renvoyée =
LPDISPATCH
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 distant pour
le nouvel objet.
La valeur renvoyée est un pointeur vers
un objet envoi OLE. L'objet est un objet
CHostData.
Voir Exemple de code Visual C++ pour
la fonctionnalité Hôte.
Définitions d'objets Visual C++
objet CHostData
Méthode
Paramètre ou
valeur renvoyés
LPDISPATCH
Parameter =
CreateObjectEx(LPCTSTR LPCTSTR
lpszName);
lpszFQName
Valeur renvoyée =
LPDISPATCH
Description
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.
La valeur renvoyée est un pointeur vers
un objet envoi OLE. L'objet est un objet
CHostDataEx.
Voir Exemple de code Visual C++ pour
la fonctionnalité Hôte.
BOOL
DeleteObject(LPCTSTR
lpszFQName);
Parameter =
LPCTSTR
lpszFQName
Supprime un fichier d'objet hôte.
BOOL
DeleteObject(LPCTSTR
lpszPassword);
Parameter =
LPCTSTR
lpszPassword
Mot de passe de l'objet. Peut être NULL.
BOOL DeleteObject
Valeur renvoyée =
booléen
VRAI si l'objet est supprimé.
BOOL Launch(LPCTSTR
lpszFQName);
Parameter =
LPCTSTR
lpszFQName
Lance un fichier d'objet hôte, ce qui
ouvre la fenêtre de terminal de l'hôte
pcAnywhere.
Valeur renvoyée =
booléen
Le paramètre est le fichier objet hôte
entièrement qualifié de l'objet à lancer.
Le paramètre est le fichier objet hôte
entièrement qualifié de l'objet à
supprimer.
La valeur renvoyée est VRAI si l'objet
est lancé avec succès.
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.
77
78
Définitions d'objets Visual C++
objet CHostData
Le numéro de téléphone est le numéro à composer pour établir une connexion par
modem avec un ordinateur distant pcAnywhere.
BSTR GetPhoneNumber();
void SetPhoneNumber(LPCTSTR lpszNewValue);
Indique si des propriétés de 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 les propriétés de numérotation sont utilisées, il s'agit du code de 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);
Définitions d'objets Visual C++
objet CHostData
Méthodes de détail d'objet hôte
Lorsqu'un type de connexion est affecté à un objet hôte, les détails du périphérique
sont définis sur des valeurs par défaut valides.
Les types de connexion suivants 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 le type 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é. Il est normal d'appeler la méthode AssignConnection sur le 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 objet hôte pcAnywhere peut prendre en charge jusqu'à deux types de connexion
affectés. La méthode AssignConnection renvoie FAUX si elle détecte une tentative
de dépassement de cette limite.
Les types de connexion suivants sont disponibles :
■
COM1
■
COM2
■
COM3
■
COM4
■
SPX
■
NetBIOS
79
80
Définitions d'objets Visual C++
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 TAPI utilise le premier périphérique TAPI trouvé dans le 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);
Définitions d'objets Visual C++
objet CHostData
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)
■
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
81
82
Définitions d'objets Visual C++
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
void
BOOL
void
GetNasiSessionName();
SetNasiSessionName(LPCTSTR lpszNewValue);
GetNasiSessionNameAvailable();
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
BSTR
void
BOOL
void
NasiPort();
GetNasiPortName();
SetNasiPortName(LPCTSTR lpszNewValue);
GetNasiSelectOnConnect();
SetNasiSelectOnConnect(BOOL bNewValue);
Définitions d'objets Visual C++
objet CHostData
Détails de périphérique RNIS via CAPI2.0
Active la liaison de canaux (utilise deux canaux RNIS pour une connexion) si VRAI.
BOOL GetCapiChannelBonding();
void SetCapiChannelBonding(BOOL bNewValue);
Définit toute extension CAPI supplémentaire nécessaire pour les communications.
BSTR GetCapiExtensions();
void SetCapiExtensions(LPCTSTR lpszNewValue);
Méthodes d'objet hôte
Les tableaux suivants décrivent les méthodes normales de l'objet (elles ne servent
pas à obtenir et à définir les propriétés de l'objet).
Méthode
Paramètre ou
Description
valeur renvoyés
short ConnectionTypes();
Valeur retournée Renvoie le nombre de types de connexion
= Court
disponibles sur cet ordinateur
BSTR
FirstConnectionType(); et
BSTR
NextConnectionType();
Valeur renvoyée
= BSTR
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é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.
BOOL
Paramètre =
Le paramètre est le nom d'un type de
FindConnectionType(LPCTSTR LPCTSTR
périphérique de connexion
lpszConnectionType);
lpszConnectionTyp
La valeur renvoyée est VRAIE si ce type
Valeur renvoyée de périphérique est disponible
= booléen
short
Valeur retournée Renvoie le nombre maximum de types de
MaxAssignedConnections() = Court
connexion qui peuvent être affectés
simultanément (actuellement deux).
short
AssignedConnections()
Valeur retournée Renvoie le nombre de types de connexion
= Court
affectés.
83
84
Définitions d'objets Visual C++
objet CHostData
Méthode
Paramètre ou
Description
valeur renvoyés
BSTR
Valeur renvoyée
FirstAssignedConnection(); = BSTR
et BSTR
NextAssignedConnection();
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 de connexion renvoyés peuvent ê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.
BOOL
FindAssignedConnection
(LPCTSTR
lpszConnectionType);
Paramètre =
Le paramètre est le nom d'un type de
LPCTSTR
périphérique de connexion
lpszConnectionTyp
La valeur renvoyée est VRAI si ce type de
Valeur renvoyée périphérique est actuellement affecté
= booléen
short CountryCodes();
Valeur retournée Renvoie le nombre d'indicatifs
= Court
internationaux disponibles.
BSTR FirstCountryCode();
et BSTR
NextCountryCode();
Valeur renvoyée
= BSTR
FirstCountryCode() et NextCountryCode()
servent à itérer parmi la liste des
indicatifs internationaux disponibles. Les
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'indicatif international ou chaîne
suivante.
BOOL ReadObject(LPCTSTR Parameter =
lpszPassword);
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.
Définitions d'objets Visual C++
objet CHostDataEx
Méthode
Paramètre ou
Description
valeur renvoyés
BOOL
WriteObject(LPCTSTR
lpszPassword);
Paramètre =
LPCTSTR
lpszPassword
Valeur renvoyée
= booléen
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.
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);
85
86
Définitions d'objets Visual C++
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);
Définitions d'objets Visual C++
objet CHostDataEx
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 sur TCP/IP, définit le nom de 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) );
// 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);
}
87
88
Définitions d'objets Visual C++
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
Paramètre ou
Description
valeur renvoyés
boolean awConnect(BSTR
FileName);
Paramètre = Nom Crée la connexion à l'ordinateur hôte.
comme chaîne
Le paramètre est le nom intégralement
Valeur renvoyée = qualifié du fichier .chf contenant les
booléen
informations sur l'ordinateur hôte.
La valeur renvpyée exécute la
commande
boolean awDisconnect();
Valeur renvoyée = Déconnecte l'ordinateur hôte.
booléen
Après avoir appelé cette fonction, le
programme appelant doit supprimer
l'objet (C++ - delete IAwrem32X*, VB –
set ObjectName = Nothing;).
boolean
FileXferFromHost(BSTR
HostFile);
Paramètre =
HostFile comme
chaîne
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ètre contient le chemin 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);
Paramètre =
RemoteFile
comme chaîne
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ètre contient le chemin d'accès
de destination et le nom de fichier,
entièrement qualifiés. Les chaînes de
fichier hôte et de fichier distant ne sont
pas obligatoirement identiques.
boolean FileXferFromHost
Valeur renvoyée = VRAI si la commande est exécutée.
booléen
Définitions d'objets Visual C++
fonctions awrem32
Méthode
Paramètre ou
Description
valeur renvoyés
boolean
FileXferToHost(BSTR
HostFile);
Paramètre =
HostFile comme
chaîne
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. Les chaînes de
fichier hôte et de fichier distant ne sont
pas obligatoirement identiques.
boolean
FileXferToHost(BSTR
RemoteFile);
Paramètre =
RemoteFile
comme chaîne
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
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.
boolean FileXferToHost
Valeur renvoyée = VRAI si la commande est exécutée.
booléen
boolean
CreateFolderOnHost(BSTR
FolderName);
Paramètre = Nom Crée un nouveau dossier sur l'ordinateur
de dossier comme hôte. Cette fonction crée un dossier
chaîne
temporaire sur l'ordinateur distant, puis
copie ce dossier sur l'ordinateur hôte.
Valeur renvoyée =
booléen
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.
89
90
Définitions d'objets Visual C++
fonctions awrem32
Méthode
Paramètre ou
Description
valeur renvoyés
boolean
ExecuteHostFile(BSTR
FileName);
Paramètre = Nom Exécute un fichier existant sur
de fichier comme l'ordinateur hôte. Cette fonction ne peut
chaîne
exécuter que les fichiers batch, de
commandes et exécutables. Elle
Valeur renvoyée =
n'exécute pas les fichiers associés aux
booléen
exécutables. Par exemple, elle n'ouvre
pas Microsoft Word si vous 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.
BSTR GetError();
Valeur renvoyée = Renvoie la dernière erreur générée dans
Chaîne
Awrem32, comme chaîne.
short ConnectionStatus();
Valeur retournée
= Court
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
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
92
Index
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
Index
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
93
">