SYMANTEC pcAnywhere v12.5 User Manual [fr]
Guide d'automatisation OLE
Guide d'automatisation OLE
Mentions légales
Copyright © 2008 Symantec Corporation. Tous droits réservés.
Symantec et le logo Symantec sont des marques commerciales ou déposées de Symantec
Corporation oude sesfiliales, auxEtats-Unis etdans d'autrespays., Lesautres nomspeuvent
être des marques de leurs détenteurs respectifs.
Ce produit Symantec peut contenir un logiciel tiers pour lequel Symantec est requis pour
l'attribution à tiers ("Programmes tiers"). Certains programmes tiers sont disponibles sous
licences desource ouverteou de logiciellibre. lecontrat delicence accompagnant le Logiciel
ne modifie aucun droit ou engagement que vous pouvez avoir sous des licences de source
ouverte ou de logiciel libre. Veuillez consulter l'annexe des mentions légales de cette
documentation ou le fichier lisez-moi TPIP accompagnant ce produit Symantec pour plus
d'informations sur les programmes tiers.
Le produit décrit dans ce document est distribué aux termes d'une licence limitant son
utilisation, sa copie, sa distributionet sa décompilation/ingénierie inverse. Cedocument ne
peut, en tout ou partie, être reproduit sous aucune forme et par aucun moyen sans
l'autorisation préalable écrite de Symantec Corporation et de ses détenteurs de licence
éventuels.
LA DOCUMENTATIONEST FOURNIE"EN L'ETAT",ET TOUTEGARANTIE OUCONDITION
D'AUCUNE SORTE, EXPRESSE OU IMPLICITE, Y COMPRIS, SANS QUE CELA SOIT
LIMITATIF, LES GARANTIES OU CONDITIONS IMPLICITES DE QUALITE MARCHANDE,
D'ADEQUATION A UNUSAGE PARTICULIER OU DE RESPECTDES DROITS DE PROPRIETE
INTELLECTUELLE EST TENUE POUR JURIDIQUEMENT NON VALIDE. SYMANTEC
CORPORATION NE POURRA PAS ETRE TENUE RESPONSABLE DE DOMMAGES DIRECTS
OU INDIRECTS EN RELATION AVEC LE CONTENU OU L'UTILISATION DE LA PRESENTE
DOCUMENTATION. LES INFORMATIONS PRESENTES DANS CETTE DOCUMENTATION
SONT SUJETTES A MODIFICATION SANS PREAVIS.
Le logiciel et la documentation sous licence sont considérés "logiciel informatique
commercial" et "documentation de logiciel informatique commercial" t sujets aux droits
restreints selon les définitions des sections FAR 12.212 et DFARS 227.7202 autant
qu'applicables, ainsi que toute régulation issue de celles-ci. Toute utilisation, modification,
reproduction de version, performance, affichage ou divulgation du logiciel et de la
documentation sous licence, par le gouvernement des Etats-Unis, ne peut s'effectuer que
selon les termes de cet accord.
Symantec Corporation
20330 Stevens Creek Blvd.
Cupertino, CA 95014
http://www.symantec.fr
Fabriqué en Irlande.
10 9 8 7 6 5 4 3 2 1
Support technique
Le support technique de Symantec gère lescentres de support au niveau mondial.
Le supporttechnique a pour rôle essentiel de répondre à des demandes spécifiques
sur lescaractéristiques et les fonctions des produits. Ilest égalementresponsable
de la création des articlesde notre base de donnéesen ligne. Le groupe de support
technique collaboreavec lesautres entitésde Symantec pour répondre rapidement
à vos questions. Il travaille par exemple avec le département Ingénierie et
Symantec Security Response pour fournir des services d'alerte et desmises à jour
des définitions de virus.
Parmi les offres de maintenance de Symantec, il faut citer :
■ Une gammed'options desupport pourvous permettre de sélectionner le niveau
de service adapté à votre entreprise.
■ Un support par téléphone et sur le Web apportant des réponses rapides et des
informations de dernière minute.
■ Une assurance Mise à niveau fournissant une protection de la mise à niveau
automatique de logiciels.
■ Un support global de 24 heures sur 24 et 7 jours sur 7.
■ Des prestations évoluées telles que la gestion de compte de service.
Pour plus d'informations sur les programmes de maintenance proposés par
Symantec, visitez notre site Web à l'adresse suivante :
www.symantec.com/techsupp/
Entrer en contact avec le support technique
Les clients avec un contrat de maintenance en cours peuvent accéder à des
informations de support technique à l'URL suivante :
www.symantec.com/techsupp/
Avant d'entreren contact avec le support technique, assurez-vousd'avoir satisfait
la configuration requise indiquée dans votre documentation produit. En outre,
vous devriez être à l'ordinateur sur lequel le problème s'est produit, au cas où il
serait nécessaire de recréer le problème.
Quand vous entrez en contact avec le support technique, ayez s'il vous plaît les
informations suivantes disponibles :
■ Niveau de version du produit
■ Informations concernant le matériel
■ Mémoire disponible, espace disque, informations NIC
■ Système d'exploitation
■ Version et niveau de correctif
■ Topologie réseau
■ Routeur, passerelle, et informations d'adresse IP
■ Description du problème :
■ Messages d'erreur et fichiers journaux
■ Dépannage effectué avant d'entrer en contact avec Symantec
■ Changements deconfiguration récentsdu logicielet changementsde réseau
Licence et enregistrement
Si votreproduit Symantec requiert un enregistrement ou une clé delicence, visitez
la page Web de notre support technique à l'adresse suivante :
www.symantec.com/techsupp/
Service clientèle
Les informations de Service clientèle sont disponibles à l'URL suivante :
www.symantec.com/techsupp/
Le Service clientèle peut vous aider à résoudre des problèmesdes types suivants :
■ licence et numéros de série des produits ;
■ mise à jour des enregistrements de produit en cas de changement de nom ou
d'adresse ;
■ informations généralessur les produits (caractéristiques, langues disponibles,
distributeurs) ;
■ dernières informations sur les mises à jour et mises à niveau des produits ;
■ informations surles assurancesde mise à jour et les contrats de maintenance ;
■ informations au sujet de l'achat de programmes Symantec ;
■ conseil sur les options de support technique de Symantec ;
■ questions avant-vente non techniques ;
■ questions concernant les CD-ROM ou les manuels.
Ressources des accords de maintenance
Pour touteinformation sur les accords de maintenance, veuillez contacter l'équipe
administrative responsable de votre région :
contractsadmin@symantec.comAsie-Pacifique et Japon
semea@symantec.comEurope, Moyen-Orient et Afrique
supportsolutions@symantec.comAmérique du Nord et Amérique latine
Services supplémentaires destinés aux entreprises
Symantec propose un ensemble complet de services qui vous permettront de
rentabiliser aumaximum vosproduits Symantec,de développervos compétences
et d'avoir une meilleure vue d'ensemble pour gérer plus efficacement les risques
auxquels votre entreprise doit faire face.
Les services destinés aux entreprises sont les suivants :
Symantec EarlyWarning Solutions
Services de supervision de la
sécurité
Services de conseil
Services de formation
Pour accéder à des informations supplémentaires concernant les services
d'entreprise, visitez notre site Web à l'adresse :
www.symantec.com
Sélectionnez le pays et la langue de votre choix dans l'index du site.
Ces solutions permettent que vous soyez prévenu précocement en cas de
cyber-attaque et vous appuyer sur une analyse exhaustive des menaces et des
contre-mesures pour prévenir les attaques avant qu'elles ne frappent.
Ces services évitent l'obligation de gérer et superviser les périphériques et les
événements de sécurité, garantissant ainsi une réponse rapide aux menaces
réelles.
Symantec Consulting Services garantissent une expertise technique sur site
apportée directement par Symantec ou ses partenaires agréés. Symantec
Consulting Servicespropose unesérie d'optionspréconçues etpersonnalisables
qui incluent des fonctions d'évaluation, de conception, de mise en oeuvre, de
surveillance et de gestion. Chacune porte sur l'établissement et la mise à jour
de l'intégrité et de la disponibilité de vos ressources informatiques.
Les services de formations fournissent une gamme complète de programmes
de formation technique, de formation à la sécurité, de certification de sécurité
et de communication de sensibilisation.
Table des matières
Support technique .. .... .... .... .... .... .... .... .... .... . ... . ... . ... . ... . ... . ... . ... . ... . .... .... .... .... .... ... 4
Chapitre 1 Utilisation de l'automatisation OLE avec Symantec
pcAnywhere . .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... . 9
A propos de l'automatisation OLE .... .... .... .... .... .... .... .... .... .... .... .... .... . 9
A propos du serveur d'automatisation pcAnywhere ... .... .... .... .... .... .... . 10
Ce que vous pouvez faire avec le serveur d'automatisation
pcAnywhere .... .... .... . ... . ... . ... . ... . ... . ... . ... . ... . .... .... .... .... .... .... .... . 10
Avant de commencer ... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... . 11
Inscription automatique du moteur distant ... .... .... .... .... .... .... .... .. 11
Inscription manuelle du moteur distant .... .... .... .... .... .... .... .... .... . 12
Accès au serveur d'automatisation pcAnywhere ... .... .... .... .... .... .... 12
Accès au serveur d'automatisation pcAnywhere avec Visual
Basic .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .. 12
Accès au serveur d'automatisation pcAnywhere avec Visual
C++ . .... .... .... .... .... .... .... . ... . ... . ... . ... . ... . ... . ... . ... . .... .... .... .... . 14
Démarrage des objets OLE hôte et distant ... .... .... .... .... .... .... .... .... 16
Pour plus d'informations . ... . ... . .... .... .... .... .... .... .... .... .... .... .... .... .... .. 16
Chapitre 2 Définitions d'objets Visual Basic .... .... .... .... .... .... .... .... .... .. 17
A propos des objets Visual Basic .... .... .... .... .... .... .... .... .... .... .... .... .... .. 17
Méthodes CRemoteDataManager .... .... .... .... .... .... .... .... .... .... .... .... .... 18
Propriétés CRemoteData . .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .. 21
Propriétés du type de connexion .... .... .... .... .... .... .... .... .... .... .... ... 23
Propriétés de numérotation . .... .... .... .... .... .... .... .... .... .... .... .... .... 25
Propriétés de périphérique COM .... .... .... .... .... .... .... .... .... .... .... ... 26
Propriétés de périphérique NetBIOS . .... .... .... .... .... .... .... .... .... .... . 29
Propriétés de périphérique RNIS via CAPI 2.0 ... .... .... .... .... .... .... ... 30
objet CRemoteDataEx . ... . ... . ... . ... . ... . ... . .... .... .... .... .... .... .... .... .... .... .. 31
Exemple de code Visual Basic pour la fonction distant .... .... .... .... ... 32
Méthodes CHostDataManager ... .... .... .... .... .... .... .... .... . ... . ... . ... . ... . ... . 34
Propriétés CHostData .... .... .... .... .... .... .... .... . ... . ... . ... . ... . ... . ... . ... . ... . .. 37
Propriétés du type de connexion .... .... .... .... .... .... .... .... .... .... .... ... 39
Méthode AssignConnection(type de connexion) ... .... .... .... .... .... .... 42
Méthode UnassignConnection (type de connexion) ... . ... . ... . ... . ... . ... 42
Table des matières8
Propriétés de numérotation . .... .... .... .... .... .... .... .... .... .... .... .... .... 43
Propriétés de périphérique COM .... .... .... .... .... .... .... .... .... .... .... ... 44
Propriétés de périphérique NetBIOS . .... .... .... .... .... .... .... .... .... .... . 47
Propriétés de périphérique RNIS via CAPI 2.0 ... .... .... .... .... .... .... ... 48
objet CHostDataEx .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... ... 48
Exemple de code Visual Basic pour la fonctionnalité hôte. .... .... .... .. 56
fonctions awrem32 . .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .. 58
Chapitre 3 Définitions d'objets Visual C++ . .... .... .... .... .... .... .... .... .... ... 61
A propos des objets Visual C++ . .... .... .... .... .... .... .... .... .... .... .... .... .... .. 61
Méthodes CRemoteDataManager .... .... .... .... .... .... .... .... .... .... .... .... .... 62
objet CRemoteData . . ... . ... . ... . ... . ... . ... . ... . .... .... .... .... .... .... .... .... .... .... . 66
Méthodes Get et Set (obtenir et définir) ... .... .... .... .... .... .... .... .... ... 66
Méthodes de détail d'objet distant .... .... .... .... .... .... .... .... .... .... .... . 68
Méthodes d'objet distant ... .... .... .... .... .... .... .... .... .... .... .... .... .... .. 71
objet CRemoteDataEx . ... . ... . ... . ... . ... . ... . .... .... .... .... .... .... .... .... .... .... .. 72
Exemple de code Visual C++ pour la fonctionnalité du
distant .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... ... 72
Méthodes CHostDataManager ... .... .... .... .... .... .... .... .... . ... . ... . ... . ... . ... . 73
objet CHostData . .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .. 77
Méthodes Get et Set (obtenir et définir) ... .... .... .... .... .... .... .... .... ... 77
Méthodes de détail d'objet hôte . .... .... .... .... .... .... .... .... .... .... .... .... 79
Méthodes d'objet hôte .... .... .... .... .... .... . ... . ... . ... . ... . ... . ... . ... . ... . .... 83
objet CHostDataEx .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... ... 85
Exemple de code Visual C++ pour la fonctionnalité Hôte ... . ... . ... . ... . 87
fonctions awrem32 . .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .. 88
Index ... . ... . ... . ... . ... . ... . .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... .... 91
Chapitre
Utilisation de l'automatisation OLE avec Symantec pcAnywhere
Ce chapitre traite des sujets suivants :
■ A propos de l'automatisation OLE
■ A propos du serveur d'automatisation pcAnywhere
■ Ce que vous pouvez faire avec le serveur d'automatisation pcAnywhere
1
■ Avant de commencer
■ Pour plus d'informations
A propos de l'automatisation OLE
L'automatisation OLE est une technologie qui permet de créer une application
externe ou un autre outil de développement (par exemple unscript ou une macro)
capable de contrôler et d'automatiser toute fonction exposée d'une application.
L'automatisation OLE est constituée des composants suivants :
un serveur d'automatisation
OLE ;
une application ou composant logiciel qui expose sa
fonction afin d'être accessible ou de pouvoir être contrôlé
par d'autres applications ou d'autres outils de
développement.
Le serveur d'automatisation pcAnywhere est un exemple
de serveur d'automatisation OLE ;
Utilisation de l'automatisation OLE avec Symantec pcAnywhere
10
A propos du serveur d'automatisation pcAnywhere
un contrôleur
d'automatisation OLE ;
Une application externe accède à un serveur d'automatisation en se connectant
au serveur,puis en demandant l'accès à une ouplusieurs deses interfacespubliées.
Une interface est un point d'entrée permettant d'accéder à une ou plusieurs
méthodes ou propriétés rattachées. Une fois que l'application a obtenu une
interface vers le serveur, elle peut appeler toute méthode d'interface comme si
celle-ci faisait partie de l'application externe.
une application ou outil de développement pouvant
atteindre etcontrôler lescomposants exposéspar leserveur
d'automatisation OLE.
Vous pouvez utiliser tout langage de programmation
prenant encharge l'automatisationOLE. Lesdeux langages
de programmation les plus courants sont Microsoft Visual
Basic et Microsoft Visual C++.
A propos du serveur d'automatisation pcAnywhere
Le serveur d'automatisation pcAnywhere permet aux applications externes de
gérer les fichiers pcAnywhere Hôte et Distant afin d'automatiser les tâches de
téléintervention et de transfert de fichiers. Le serveur d'automatisation
pcAnywhere fonctionne comme un substitut programmable de l'interface
utilisateur de Symantec pcAnywhere et reprend dans une large mesure son
comportement par défaut.
Par exemple,lorsque vouscréez unobjet hôtedans pcAnywhere,le premiermodem
TAPI disponible est attribué par défaut. De même, si vous créez un objet hôte à
l'aide du serveur d'automatisation pcAnywhere, puis que vous énumérez la liste
des connexions attribuées, le premier modem TAPI disponible est déjà attribué.
Ce que vous pouvez faire avec le serveur d'automatisation pcAnywhere
Le serveur d'automatisation pcAnywhere vous permet d'automatiser diverses
tâches administratives et de productivité.
Vous pouvez utiliser serveur d'automatisation pcAnywhere pour effectuer les
actions suivantes :
■ Distribution et installation automatiques de mises à jour logicielles sur
plusieurs ordinateurs du réseau
■ Programmation detransferts automatiques de fichiers entre ordinateurs à des
fins d'audit ou d'archivage
■ Ajouter ou supprimer automatiquement un nom de la liste des appelants sur
chaque hôte pcAnywhere de votre réseau
Ce document comporte plusieurs exemples, écrits à la fois en Visual Basic et en
Visual C++,afin d'illustrer la manière de se connecterau serveurd'automatisation
pcAnywhere et de l'utiliser.
Se reporter à "A propos des objets Visual Basic" à la page 17.
Se reporter à "A propos des objets Visual C++" à la page 61.
Avant de commencer
Au cours d'une connexion au serveur d'automatisation pcAnywhere et à ses
interfaces, les paramètres d'identification, appelés GUID (Globally Unique
Identifiers - identificateurs globalement uniques), sont transmis aux fonctions
API de la bibliothèque d'automatisation. Un GUID distinctest attribué au serveur
d'automatisation pcAnywhere et à chaque interface exposée. Ces GUID doivent
être présents dans le registre système pour connecter une application externe au
serveur d'automatisation pcAnywhere et à ses interfaces.
Si vous exécutez l'application externe sur un ordinateur sur lequel Symantec
pcAnywhere estinstallé, vouspouvez inscrire automatiquement les entrées GUID.
Dans le cas contraire, vous devez enregistrer les entrées GUID manuellement.
Se reporter à "Inscription automatique du moteur distant" à la page 11.
Se reporter à "Inscription manuelle du moteur distant" à la page 12.
Avant de commencer
11Utilisation de l'automatisation OLE avec Symantec pcAnywhere
Inscription automatique du moteur distant
Avant de vous connecter à un autre ordinateur pour la première fois en utilisant
votre client OLE, vous devez inscrire automatiquement le moteur distant. Cette
opération peut s'effectuer automatiquement lorsque vous démarrez un objet
distant dans Symantec pcAnywhere.
Pour inscrire automatiquement le moteur distant
Pour ouvrirSymantec pcAnywhere, effectuez l'une des opérations suivantes :
1
■ Sur le bureau, cliquez deux fois sur l'icône du programme Symantec
pcAnywhere.
Utilisation de l'automatisation OLE avec Symantec pcAnywhere
12
Avant de commencer
■ Dans la barre des tâches de Windows, cliquez sur Démarrer>
Programmes> Symantec pcAnywhere.
Dans la fenêtre du Gestionnaire pcAnywhere, cliquez sur Distants.
2
Cliquez deux fois sur un élément de connexion distante.
3
Cette procédure inscrit le moteur distant. Il n'est pas nécessaire de terminer
la connexion.
Inscription manuelle du moteur distant
Si pcAnywhere n'est pas installé sur l'ordinateur sur lequel vous exécutez
l'application externe, vous devez inscrire manuellement les GUID en exécutant
le fichier exécutable (winawsvr.exe) du serveur d'automatisation pcAnywhere. Il
suffit de lancer l'exécutable une seule fois pour ajouter les GUID au registre. Le
fichier Winawsvr.exe se trouve dans le répertoire d'installation.
Accès au serveur d'automatisation pcAnywhere
Vous pouvez accéder au serveur d'automatisation de pcAnywhere en utilisant
toute plate-formeprenant encharge l'automatisation OLE. Les deux plates-formes
les plusrépandues quiprennent en charge l'automatisation OLE sont Visual Basic
et Visual C++.
Les principes de codage de ces deux plates-formes sont similaires, bien que dans
l'environnement Visual Basic une part importante des tâches de bas niveau est
exécutée en arrière-plan par l'exécutable Visual Basic.
Accès au serveur d'automatisation pcAnywhere avec Visual Basic
Le langage de programmation Visual Basic intègre la prise en charge de
l'interaction avec les serveurs d'automatisation OLE tels que le serveur
d'automatisation pcAnywhere. Vous pouvez créer un projet Exe standard puis,
dans chaque méthode, entrer le code pour accéder au serveur d'automatisation
pcAnywhere. Visual Basic prend les appels de méthode de haut niveau dans les
fichiers source et les développe de façon interne dans les appels de méthode de
bas niveau correspondants de l'automatisation OLE.
Avant de commencer
Pour accéder au serveur d'automatisation pcAnywhere avec Visual Basic
Ajoutez une paire de variables objet pour chaque objet pcAnywhere auquel
1
accéder.
Par exemple, pour travailler avec des objets distant, dimensionnez un objet
RemoteDataManager et RemoteDataObject.
Utilisez RemoteDataManagerpour lerattachement augestionnaire dedonnées
2
de l'objet distant.
Par exemple, appelez la méthode CreateObject avec
WINAWSVR.REMOTEDATAMANAGER comme paramètre.
Visual Basic utilise le paramètre textuel pour repérer l'identificateur du
gestionnaire dans la base de registres et renvoie l'interface vers ce
gestionnaire.
Une fois qu'il existe un objet gestionnaire de données valide, utilisez-le pour
3
effectuer les opérations suivantes :
■ Déterminer le répertoire en cours
■ Accéder à un autre répertoire
■ Enumérer lesfichiers objet de données associés dans le répertoire encours
13Utilisation de l'automatisation OLE avec Symantec pcAnywhere
■ Créer, extraire ou supprimer un fichier objet de données
Après la création ou la récupération d'un objet de données, vous pouvez
4
obtenir (Get) ou définir (Set) ses propriétés.
La syntaxede Visual Basic n'utilise pas de nom de propriété pour différencier
l'obtention et la définition de sa valeur. C'est la position de la propriété par
rapport à l'opérateur d'affectation qui détermine si l'appel de méthode
sous-jacent est un Get ou un Set.
Les exemples suivants illustrent un Get et un Set :
■ Pour obtenir la valeur du numéro de téléphone d'un objet, placez le nom
de la propriété à droite de l'opérateur d'affectation.
Par exemple, s = RemoteData.PhoneNumber(), où s est une variable de
type chaîne.
■ Pour configurer le numéro de téléphone, placez le nom de la propriété à
gauche de l'opérateur d'affectation.
Par exemple, RemoteData.PhoneNumber = "555-1212"
Utilisation de l'automatisation OLE avec Symantec pcAnywhere
14
Avant de commencer
Accès au serveur d'automatisation pcAnywhere avec Visual C++
Le serveur d'automatisation pcAnywhere utilise des bibliothèques de type pour
exposer lesinformations concernant ses interfaces et ses méthodes vers lesclients
d'automatisation, quisont écrits en Visual C++. Ces bibliothèquesde type utilisent
des MFC (Microsoft Foundation Classes), qui peuvent être importées dans votre
application via l'assistant ClassWizard de Visual C++.
Les classes du gestionnaire de données fournies dans les bibliothèques de type
contiennent la fonction nécessaire pour obtenir une interface vers le serveur
d'automatisation pcAnywhere et effectuer des opérations de haut niveau sur le
type d'objet associé à l'interface.
Utiliser l'objet gestionnaire de données pour effectuer les opérations suivantes :
■ Déterminer ou modifier le répertoire en cours.
■ Enumérer les fichiers objet de données du répertoire en cours.
■ Créer, extraire ou supprimer un objet nommé.
Une fois créé ou récupéré, un objet utilise la classe d'objet de données associée
pour examiner ou modifier ses propriétés exposées. La plupart de ces propriétés
sont exposées à travers une paire de méthodes qui commencent par le mot Get
ou Set. Par exemple, un utilisateur appelle la méthode GetPhoneNumber pour
examiner la propriété de numéro de téléphone en cours de l'objet et appelle
SetPhoneNumber pour la définir.
Importation et affichage des classes
Le serveur d'automatisation pcAnywhere utilise les bibliothèques de type
suivantes :
Winawsvr.tlb
Awrem32.tlb
Les procéduressuivantes expliquent comment importer les bibliothèques detype
du serveurd'automatisation pcAnywhere et afficher les classes ayantété ajoutées
à votre application.
Pour importer des classes
Créez une application MFC dans Visual C++.
1
Dans le menu Affichage, cliquez sur Assistant de classe.
2
Contient les informations nécessaires pour se connecter au serveur
d'automatisation pcAnywhere et accéder à ses interfaces.
Contient les informations nécessaires au contrôle des connexions
pcAnywhere.
Avant de commencer
Dans la boîte de dialogue Assistant de classe, cliquez sur Ajouterune classe,
3
puis cliquez sur Depuis une bibliothèque de type.
Cliquez deux fois sur winawsvr.tlb.
4
Dans la boîte de dialogue Confirmer Classes, cliquez sur OK pour importer
5
toutes les définitions de classe.
Dans la boîte de dialogue Assistant de classe, cliquez sur Ajouterune classe,
6
puis cliquez sur Depuis une bibliothèque de type.
Cliquez deux fois sur awrem32.tlb.
7
Dans la boîte de dialogue Confirmer Classes, cliquez sur OK pour importer
8
toutes les définitions de classe.
Dans la boîte de dialogue Assistant de classe, cliquez sur OK pour terminer
9
l'importation.
Les classes sont ajoutées à l'application. Elles vous permettent de manipuler
des objets et de gérer des connexions.
L'importation des définitions de classe à partir des bibliothèques de type
ajoute également des fichiers de prise en charge à l'application. Ces fichiers
contiennent les définitions de classe et le code source de mise en oeuvre du
serveur d'automatisation pcAnywhere.
Se reporter à "Affichage des définitions de classe et des fichiers de mise en
oeuvre" à la page 15.
Pour afficher les classes ajoutées
15Utilisation de l'automatisation OLE avec Symantec pcAnywhere
Dans Visual C++, ouvrez votre application MFC.
1
Dans la fenêtre de l'espace de travail, cliquez sur l'onglet ClassView.
2
Affichage des définitions de classe et des fichiers de mise en
oeuvre
Lorsque vous importez les bibliothèques de type du serveur d'automatisation
pcAnywhere dans votre application, les fichiers suivants sont ajoutés :
■ Winawsvr.h
■ Winawsvr.cpp
■ Awrem32.h
■ Awrem32.cpp
Ces fichiers contiennent les définitions de classe et le code source de mise en
oeuvre duserveur d'automatisation pcAnywhere. Il est inutile d'éditerces fichiers;
Utilisation de l'automatisation OLE avec Symantec pcAnywhere
16
Pour plus d'informations
cependant, chaque fichier source de l'application contenant des appels des
méthodes du serveur d'automatisation pcAnywhere doit inclure Winawsvr.h.
Pour afficher les définitions de classe et les fichiers de mise en oeuvre
Dans Visual C++, ouvrez votre application MFC.
1
Dans la fenêtre de l'espace de travail, cliquez sur l'onglet FileView.
2
Démarrage des objets OLE hôte et distant
Symantec pcAnywhere nécessite que tous les objetshôte et distant soient stockés
dans le répertoire de données par défaut. Avant de démarrer un objet hôte ou
distant que vous avez créé avec OLE, vérifiez qu'il se trouve dans le répertoire de
données par défaut de pcAnywhere. Le répertoire par défaut est le dossier All
Users dans Windows XP, et le dossier ProgramData dans Vista.
Pour plus d'informations
Pour plus d'informations sur l'automatisationOLE, reportez-vousaux documents
de référence suivants (en anglais) :
■ Box, Don. 1998. Essential COM. Reading, Mass.: Addison-Wesley.
■ Horton, Ivor. 1997. Commencer MFC Programming. Birmingham, RU : Wrox
Press.
■ Rogerson, Dale. 1997. Inside COM. Redmond, Wash.: Microsoft Press.
■ Templeman, Julian. 1997. Beginning MFC COM Programming. Birmingham,
RU : Wrox Press.
Chapitre
Définitions d'objets Visual Basic
Ce chapitre traite des sujets suivants :
■ A propos des objets Visual Basic
■ Méthodes CRemoteDataManager
■ Propriétés CRemoteData
■ objet CRemoteDataEx
2
■ Méthodes CHostDataManager
■ Propriétés CHostData
■ objet CHostDataEx
■ fonctions awrem32
A propos des objets Visual Basic
Le serveur d'automatisation pcAnywhere offre les composants suivants pour la
prise en charge de l'automatisation OLE :
Winawsvr
Awrem32
Le Tableau 2-1 décrit les objets qui composent Winawsvr.
contient les informations nécessaires pour se connecter au serveur
d'automatisation pcAnywhere et accéder à ses interfaces.
Contient les informations nécessaires au contrôle des connexions
pcAnywhere.
Définitions d'objets Visual Basic
18
Méthodes CRemoteDataManager
CRemoteDataManager
CRemoteData
CHostDataManager
CHostData
Tableau 2-1
Objets Winawsvr
RéférenceDescriptionObjet
Fournit les méthodes pour créer, ouvrir,
modifier, enregistrer et supprimer les
objets CRemoteData.
Définit les paramètres permettant
d'accéder à la fonction distant de
pcAnywhere et de la contrôler.
Fournit les méthodes pour créer, ouvrir,
modifier, enregistrer et supprimer les
objets ChostData.
Définit les paramètres permettant
d'accéder àla fonctionhôte depcAnywhere
et de la contrôler.
Se reporter à "Méthodes
CRemoteDataManager" à la page 18.
Se reporter à "Propriétés CRemoteData"
à la page 21.
Se reporter à "objet CRemoteDataEx"
à la page 31.
Se reporter à "Méthodes
CHostDataManager" à la page 34.
Se reporter à "Propriétés CHostData"
à la page 37.
Se reporter à "objet CHostDataEx"
à la page 48.
Awrem32 possède un objet, constitué de huit interfaces, pour prendre en charge
les sessions de téléintervention et de transfert de fichiers.
Se reporter à "fonctions awrem32" à la page 58.
Quelques fonctions ne sont plus prises en charge. Cependant, les définitions
d'objets sont utilisables avec les versions antérieures de pcAnywhere.
Pour les fonctions nécessitant des mots de passe, les valeurs des mots de passe
peuvent être définies mais non récupérées, pour des raisons de sécurité.
Méthodes CRemoteDataManager
Les méthodes CRemoteDataManager fournissent les paramètres et renvoient les
valeurs permettant d'accéder aux objets CRemoteData et de les contrôler.
Tableau 2-2
Méthode
CRemoteDataManager
CurrentDirectory()
Méthodes CRemoteDataManager
renvoyés
Valeur renvoyée =
chaîne
DescriptionParamètre ou valeur
Renvoie le chemin d'accès complet
du dossier actuel dans lequel les
objets distants pcAnywhere sont
stockés.
Méthodes CRemoteDataManager
19Définitions d'objets Visual Basic
Méthode
CRemoteDataManager
ChangeDirectory(nouveau
répertoire)
FindFirst(schéma)
FindFirst(nom)
FindNext(nom)
FindNext(nom)
renvoyés
Paramètre =
NewDirectory
Paramètre =schéma en
tant que chaîne
Paramètre = Nom
comme chaîne
Paramètre = Nom
comme chaîne
Valeur renvoyée =
booléen
DescriptionParamètre ou valeur
Change ledossier actueldans lequel
les objetsdistants pcAnywheresont
stockés.
Trouve le premier fichier d'objet
distant de pcAnywhere (*.chf) dans
le rdossieren cours; classeles noms
de fichiers de schémas sur base du
schéma spécifié de nom de fichier
(un astérisque[*] permet detrouver
tous lesfichiers dudossier encours)
Tampon de retour pour le chemin
d'accès complet du fichier d'objet
distant (*chf) correspondant au
schéma spécifié
Tampon de retour pour le chemin
d'accès complet du fichier d'objet
distant correspondant au schéma
spécifié dans l'appel initial de
FindFirst().
VRAI si un autre fichier d'objet
distant correspondant au schéma
spécifié dans l'appel de FindFirst()
est trouvé. Le chemin d'accès
complet du fichier est stocké dans
Nom.
RetrieveObject(nom)
RetrieveObject(mode
d'accès)
RetrieveObject(mot de
passe)
Paramètre = Nom
comme chaîne
Paramètre = Mode
d'accès comme valeur
entière
Paramètre = Mot de
passe comme chaîne
Nom intégralement qualifié du
fichier d'objet distant à charger.
Spécifie commentcet objetdoit être
utilisé. Ce paramètre est lié à la
protection par mot de passe.
Les options sont les suivantes :
■ 0 = Non spécifié
■ 1 = Afficher uniquement
■ 2 = Afficher et modifier
■ 3 = Exécuter
Mot de passe de l'objet. Peut être
NULL.
Définitions d'objets Visual Basic
20
Méthodes CRemoteDataManager
Méthode
CRemoteDataManager
RetrieveObjectEx(nom)
RetrieveObjectEx(mode
d'accès)
RetrieveObjectEx(mot de
passe)
RetrieveObjectEx
CreateObject(nom)
renvoyés
Paramètre = Nom
comme chaîne
Paramètre = Mode
d'accès comme valeur
entière
Paramètre = Mot de
passe comme chaîne
Valeur renvoyée =
Objet
Paramètre = Nom
comme chaîne
DescriptionParamètre ou valeur
Nom intégralement qualifié du
fichier d'objet distant à charger.
Spécifie commentcet objetdoit être
utilisé. Ce paramètre est lié à la
protection par mot de passe.
Les options sont les suivantes :
■ 0 = Non spécifié
■ 1 = Afficher uniquement
■ 2 = Afficher et modifier
■ 3 = Exécuter
Mot de passe de l'objet. Peut être
NULL.
Objet CRemoteDataEx du fichier
spécifié.
Crée un objet CRemoteData et
renvoie un pointeur LPDISPATCH
qui le désigne. Le paramètre est le
nom defichier entièrementqualifié
d'objet distant pour le nouvel objet.
CreateObject
CreateObjectEx(nom)
CreateObjectEx
DeleteObject(nom)
DeleteObject(mot de passe)
DeleteObject
Objet
Paramètre = Nom
comme chaîne
Objet
Paramètre = Nom
comme chaîne
passe comme chaîne
booléen
CRemoteDataValeur renvoyée =
Crée un objet CRemoteDataEx et
renvoie un pointeur LPDISPATCH
qui le désigne. Le paramètre est le
nom defichier entièrementqualifié
d'objet distant pour le nouvel objet.
CRemoteDataExValeur renvoyée =
Nom intégralement qualifié du
fichier d'objet distant de l'objet à
supprimer.
Mot de passe de l'objetParamètre = Mot de
VRAI si l'objet est supprimé.Valeur renvoyée =
Propriétés CRemoteData
Les propriétéset lesparamètres disponiblespour l'objet CRemoteData sont affichés
comme suit.
Dans Tableau 2-3, remplacez les informations entre les chevrons par les valeurs
réelles.
Propriétés CRemoteData
21Définitions d'objets Visual Basic
Tableau 2-3
CRemoteData - Propriétés et paramètres
DescriptionParamètrePropriété
Chaîne<CRemoteData>.ComputerName(chaîne)
Chaîne<CRemoteData>.PhoneNumber(chaîne)
Bool<CRemoteData>.UseDialingProperties(Bool)
Entier<CRemoteData>.RedialCount(entier)
Entier<CRemoteData>.RedialDelay(entier)
Chaîne<CRemoteData>.AutoLoginName(chaîne)
Chaîne<CRemoteData>.AutoLoginPassword(chaîne)
Définit le nom ou l'adresse IP de l'ordinateur
hôte.
Définit lenuméro detéléphone del'ordinateur
hôte.
Définit les propriétés de numérotation du
système.
Définit lenombre detentatives derappel avant
l'annulation de l'appel.
Définit le nombre de secondes d'attente entre
les tentatives de rappel.
Définit le nom de l'utilisateur pour la
connexion automatique.
Pour plusd'informations surl'utilisation de la
connexion aux domaines, reportez-vous à la
section :
Se reporter à "objet CRemoteDataEx"
à la page 31.
Définit le mot de passe pour la connexion
automatique dans l'objet distant.
Pour des raisons de sécurité, le serveur
d'automatisation pcAnywhere ne permet pas
de lire la valeur du mot de passe. Aucune
valeur de mot de passe n'est renvoyée.
Définitions d'objets Visual Basic
22
Propriétés CRemoteData
DescriptionParamètrePropriété
Chaîne<CRemoteData>.Password(chaîne)
Bool<CRemoteData>.ExecuteProtection (Bool)
Bool<CRemoteData>.ReadProtection(Bool)
Bool<CRemoteData>.WriteProtection(Bool)
Bool<CRemoteData>.LogSession (Bool)
Chaîne<CRemoteData>.RecordFile(chaîne)
Bool<CRemoteData>.RecordSession(Bool)
Définit le mot de passe sur l'objet distant, à
utiliser avec les méthodes ExecuteProtection,
ReadProtection et WriteProtection.
Pour des raisons de sécurité, le serveur
d'automatisation pcAnywhere ne permet pas
de lire la valeur du mot de passe. Aucune
valeur de mot de passe n'est renvoyée.
Définit la nécessité d'un mot de passe pour
exécuter l'objet. Définir par mot de passe.
Définit la nécessité d'un mot de passe pour
afficher lespropriétés del'objet distant.Définir
par mot de passe.
Définit la nécessité d'un mot de passe pour
enregistrer les modification de l'objet distant.
Définir par mot de passe.
Active et désactive la consignation des
sessions.
Définit le nom et le chemin d'accès
intégralement qualifié du fichier
d'enregistrement de la session active.
Active et désactive la consignation
automatique de session.
Chaîne<CRemoteData>.ReadObject(chaîne)
Chaîne<CRemoteData>.WriteObject(chaîne)
Définit le mot de passe de l'objet. Utilisez cette
propriété pour actualiser la copie locale des
données de l'objet distant.
Définit le mot de passe de l'objet. Utilisez cette
propriété pour créer l'objet distant ou pour
écrire les changements apportés à celui-ci.
Les propriétés et les valeurs renvoyées pour CRemoteData sont affichées dans le
tableau suivant.
Dans Tableau 2-4, remplacez les informations entre les chevrons par les valeurs
réelles.
Propriétés CRemoteData
23Définitions d'objets Visual Basic
Propriété
Tableau 2-4
CRemoteData - Propriétés et valeurs renvoyées
DescriptionValeur
renvoyée
ChaîneString = <CRemoteData>.ComputerName
ChaîneString = <CRemoteData>.PhoneNumber
BoolBool = <CRemoteData>.UseDialingProperties
EntierInteger = <CRemoteData>.RedialCount
EntierInteger = <CRemoteData>.RedialDelay
ChaîneString = <CRemoteData>.AutoLoginName
BoolBool = <CRemoteData>.ExecuteProtection
BoolBool = <CRemoteData>.ReadProtection
Renvoie le nom ou l'adresse IP de l'ordinateur
hôte
Renvoie lenuméro detéléphone del'ordinateur
hôte
Renvoie les propriétés de numérotation du
système définies dans l'objet distant
Renvoie lenombre de tentativesd'appel défini
dans l'objet distant
Renvoie lenombre desecondes d'attenteentre
les tentatives de rappel.
Renvoie le nom de l'utilisateur pour la
connexion automatique
Renvoie la valeur du paramètre
ExecuteProtection.
Renvoie la valeur du paramètre
ReadProtection.
BoolBool = <CRemoteData>.WriteProtection
ChaîneString = <CRemoteData>.RecordFile
BoolBool = <CRemoteData>.RecordSession
Propriétés du type de connexion
Le tableau suivant décrit les propriétés et les paramètres du type de connexion.
Dans Tableau 2-5, remplacez les informations entre les chevrons par les valeurs
réelles.
Renvoie la valeur du paramètre
WriteProtection
VRAI si la consignation de session est activée.BoolBool = <CRemoteData>.LogSession
Renvoie le nom et le chemin d'accès
intégralement qualifié du fichier
d'enregistrement de la session.
Renvoie la valeur du paramètre
d'enregistrement de session.
Définitions d'objets Visual Basic
24
Propriétés CRemoteData
Tableau 2-5
Type de connexion - Propriétés et paramètres
DescriptionParamètrePropriété
Chaîne<CRemoteData>.ConnectionType(chaîne)
Définit le type de connexion de l'ordinateur
distant. La valeur transmise doit être un type
de connexion valide, défini par les fonctions
FirstConnectionType() et
NextConnectionType().
Les types suivants sont des exemples de
connexions valides :
■ COM1
■ COM2
■ COM3
■ COM4
■ TCP/IP
■ SPX
■ NetBIOS
■ RNIS via CAPI 2.0
■ Nom du modem (tel qu'il apparaît sur
l'ordinateur)
Le tableau suivant décrit les propriétés et les valeurs renvoyées pour le type de
connexion.
Dans Tableau 2-6, remplacez les informations entre les chevrons par les valeurs
réelles.
Propriété
Tableau 2-6
Type de connexion - Propriétés et valeurs renvoyées
DescriptionValeur
renvoyée
Renvoie letype deconnexion del'objet distant.ChaîneString = <CRemoteData>.ConnectionTypes
Propriétés CRemoteData
25Définitions d'objets Visual Basic
Propriété
renvoyée
EntierInteger = <CRemoteData>.ConnectionType
ChaîneString = <CRemoteData>.FirstConnectionType
ChaîneString = <CRemoteData>.NextConnectionType
DescriptionValeur
Renvoie le nombre de types de connexion
disponibles.
Les types suivants sont des exemples de
connexions valides :
■ COM1
■ COM2
■ COM3
■ COM4
■ TCP/IP
■ SPX
■ NetBIOS
■ RNIS via CAPI 2.0
■ Nom du modem (tel qu'il apparaît sur
l'ordinateur)
Renvoie le premier type de connexion
disponible.
Renvoie le type de connexion disponible
suivant. L'appel s'effectue de façon
séquentielle pour le nombre de types de
connexion défini dans
<CRemoteData>.ConnectionType, afin
d'énumérer tous les types de connexion.
de connexion)
Propriétés de numérotation
Le tableausuivant décrit les propriétés et les paramètrespour définirles propriétés
de numérotation pour les connexions par modem.
Dans Tableau 2-7, remplacez les informations entre les chevrons par les valeurs
réelles.
BoolBool =<CRemoteData>.FindConnectionType(type
VRAI si le type de connexion indiqué a été
trouvé dans la liste des types de connexion
disponibles.
Définitions d'objets Visual Basic
26
Propriétés CRemoteData
Propriété
Tableau 2-7
Propriétés de numérotation - Propriétés et paramètres
DescriptionParamètrePropriété
Chaîne<CRemoteData>.AreaCode(chaîne)
Chaîne<CRemoteData>.CountryCode(chaîne)
Définit lespropriétés denumérotation decode
de zone pour les connexions par modem
Définit les propriétés de numérotation
d'indicatif international pour les connexions
par modem
Le tableausuivant définit les propriétés et les valeursrenvoyées pourles propriétés
de numérotation par modem.
Dans Tableau 2-8, remplacez les informations entre les chevrons par les valeurs
réelles.
Tableau 2-8
Propriétés de numérotation - Propriétés et valeurs renvoyées
DescriptionValeur
renvoyée
ChaîneString = <CRemoteData>.AreaCode
ChaîneString= <CRemoteData>.CountryCode
EntierInteger = <CRemoteData>.CountryCodes
Renvoie lespropriétés denumérotation de code
de zone
Renvoie les propriétés de numérotation
d'indicatif international
Renvoie lenombre d'indicatifsinternationaux
disponibles.
ChaîneString= <CRemoteData>.FirstCountryCode
ChaîneString= <CRemoteData>.NextCountryCode
Propriétés de périphérique COM
Le tableau suivant définit les propriétés et les paramètres qui vous permettent
de personnaliserles paramètres de port du modem etdes autresconnexions COM.
Dans Tableau 2-9, remplacez les informations entre les chevrons par les valeurs
réelles.
Renvoie le premier indicatif de pays
apparaissant dans la liste du système
d'exploitation.
Renvoie l'indicatif international disponible
suivant. L'appel s'effectue de façon
séquentielle pour le nombre d'indicatifs
internationaux défini dans
<CRemoteData.CountryCodes>, afin
d'énumérer tousles indicatifs internationaux.
Propriétés CRemoteData
27Définitions d'objets Visual Basic
Tableau 2-9
Périphérique COM - Propriétés et paramètre
DescriptionParamètrePropriété
Chaîne<CRemoteData>.ComParity(chaîne)
Chaîne<CRemoteData>.ComFlowControl(chaîne)
Chaîne<CRemoteData>.ComStartedBy(chaîne)
Définit la parité des communications.
Les valeurs suivantes sont valides :
■ <Aucun>
■ Impaire
■ Paire
■ Marque
■ Espace
Définit le contrôle de flux des types de
connexion COM.
Les valeurs suivantes sont valides :
■ <Aucune>
■ XONXOFF
■ RTS/CTS
■ Les deux
Définit le paramètre de début des types de
connexion COM.
Les valeurs suivantes sont valides :
■ Toujours connecté
■ Détection de porteuse (DCD)
■ Prêt à émettre (CTS)
■ Ensemble de données prêt (DSR)
■ Signal de sonnerie (RI)
■ Réception 2 <RC>
■ Réponse du modem
Chaîne<CRemoteData>.ComEndedBy(chaîne)
Définit le paramètre de fin des types de
connexion COM.
Les valeurs suivantes sont valides :
■ Toujours connecté
■ Détection de porteuse (DCD)
■ Prêt à émettre (CTS)
■ Ensemble de données prêt (DSR)
■ Signal de sonnerie (RI)
Définitions d'objets Visual Basic
28
Propriétés CRemoteData
DescriptionParamètrePropriété
Propriété
Long<CRemoteData>.ComSpeed(Long)
Contient le paramètre de vitesse COM
maximale
Les valeurs suivantes sont valides :
■ 110
■ 300
■ 600
■ 1200
■ 2400
■ 4800
■ 9600
■ 38400
■ 57600
■ 115200
Le tableausuivant décrit les propriétés et les valeursrenvoyées parle périphérique
COM.
Dans Tableau 2-10, remplacez les informations entre les chevrons par lesvaleurs
réelles.
Tableau 2-10
Périphériques COM - Propriétés et valeurs renvoyées
DescriptionValeur
renvoyée
ChaîneString = <CRemoteData>.ComParity
Renvoie l'une des valeurs suivantes comme
parité de communications :
■ <Aucune>
■ Impaire
■ Paire
■ Marque
■ Espace
ChaîneString = <CRemoteData>.ComFlowControl
Renvoie le paramètre de contrôle de flux de
l'objet distant.
Les valeurs suivantes sont valides :
■ <Aucun>
■ XONXOFF
■ RTS/CTS
■ Les deux
Loading...