Symantec et le logo Symantec sont des marques commerciales ou déposées de Symantec
Corporation oude sesfiliales, auxEtats-Unis etdans d'autrespays., Lesautres nomspeuvent
être des marques de leurs détenteurs respectifs.
Ce produit Symantec peut contenir un logiciel tiers pour lequel Symantec est requis pour
l'attribution à tiers ("Programmes tiers"). Certains programmes tiers sont disponibles sous
licences desource ouverteou de logiciellibre. lecontrat delicence accompagnant le Logiciel
ne modifie aucun droit ou engagement que vous pouvez avoir sous des licences de source
ouverte ou de logiciel libre. Veuillez consulter l'annexe des mentions légales de cette
documentation ou le fichier lisez-moi TPIP accompagnant ce produit Symantec pour plus
d'informations sur les programmes tiers.
Le produit décrit dans ce document est distribué aux termes d'une licence limitant son
utilisation, sa copie, sa distributionet sa décompilation/ingénierie inverse. Cedocument ne
peut, en tout ou partie, être reproduit sous aucune forme et par aucun moyen sans
l'autorisation préalable écrite de Symantec Corporation et de ses détenteurs de licence
éventuels.
LA DOCUMENTATIONEST FOURNIE"EN L'ETAT",ET TOUTEGARANTIE OUCONDITION
D'AUCUNE SORTE, EXPRESSE OU IMPLICITE, Y COMPRIS, SANS QUE CELA SOIT
LIMITATIF, LES GARANTIES OU CONDITIONS IMPLICITES DE QUALITE MARCHANDE,
D'ADEQUATION A UNUSAGE PARTICULIER OU DE RESPECTDES DROITS DE PROPRIETE
INTELLECTUELLE EST TENUE POUR JURIDIQUEMENT NON VALIDE. SYMANTEC
CORPORATION NE POURRA PAS ETRE TENUE RESPONSABLE DE DOMMAGES DIRECTS
OU INDIRECTS EN RELATION AVEC LE CONTENU OU L'UTILISATION DE LA PRESENTE
DOCUMENTATION. LES INFORMATIONS PRESENTES DANS CETTE DOCUMENTATION
SONT SUJETTES A MODIFICATION SANS PREAVIS.
Le logiciel et la documentation sous licence sont considérés "logiciel informatique
commercial" et "documentation de logiciel informatique commercial" t sujets aux droits
restreints selon les définitions des sections FAR 12.212 et DFARS 227.7202 autant
qu'applicables, ainsi que toute régulation issue de celles-ci. Toute utilisation, modification,
reproduction de version, performance, affichage ou divulgation du logiciel et de la
documentation sous licence, par le gouvernement des Etats-Unis, ne peut s'effectuer que
selon les termes de cet accord.
Page 3
Symantec Corporation
20330 Stevens Creek Blvd.
Cupertino, CA 95014
http://www.symantec.fr
Fabriqué en Irlande.
10 9 8 7 6 5 4 3 2 1
Page 4
Support technique
Le support technique de Symantec gère lescentres de support au niveau mondial.
Le supporttechnique a pour rôle essentiel de répondre à des demandes spécifiques
sur lescaractéristiques et les fonctions des produits. Ilest égalementresponsable
de la création des articlesde notre base de donnéesen ligne. Le groupe de support
technique collaboreavec lesautres entitésde Symantec pour répondre rapidement
à vos questions. Il travaille par exemple avec le département Ingénierie et
Symantec Security Response pour fournir des services d'alerte et desmises à jour
des définitions de virus.
Parmi les offres de maintenance de Symantec, il faut citer :
■ Une gammed'options desupport pourvous permettre de sélectionner le niveau
de service adapté à votre entreprise.
■ Un support par téléphone et sur le Web apportant des réponses rapides et des
informations de dernière minute.
■ Une assurance Mise à niveau fournissant une protection de la mise à niveau
automatique de logiciels.
■ Un support global de 24 heures sur 24 et 7 jours sur 7.
■ Des prestations évoluées telles que la gestion de compte de service.
Pour plus d'informations sur les programmes de maintenance proposés par
Symantec, visitez notre site Web à l'adresse suivante :
www.symantec.com/techsupp/
Entrer en contact avec le support technique
Les clients avec un contrat de maintenance en cours peuvent accéder à des
informations de support technique à l'URL suivante :
www.symantec.com/techsupp/
Avant d'entreren contact avec le support technique, assurez-vousd'avoir satisfait
la configuration requise indiquée dans votre documentation produit. En outre,
vous devriez être à l'ordinateur sur lequel le problème s'est produit, au cas où il
serait nécessaire de recréer le problème.
Quand vous entrez en contact avec le support technique, ayez s'il vous plaît les
informations suivantes disponibles :
■ Niveau de version du produit
■ Informations concernant le matériel
■ Mémoire disponible, espace disque, informations NIC
Page 5
■ Système d'exploitation
■ Version et niveau de correctif
■ Topologie réseau
■ Routeur, passerelle, et informations d'adresse IP
■ Description du problème :
■ Messages d'erreur et fichiers journaux
■ Dépannage effectué avant d'entrer en contact avec Symantec
Si votreproduit Symantec requiert un enregistrement ou une clé delicence, visitez
la page Web de notre support technique à l'adresse suivante :
www.symantec.com/techsupp/
Service clientèle
Les informations de Service clientèle sont disponibles à l'URL suivante :
www.symantec.com/techsupp/
Le Service clientèle peut vous aider à résoudre des problèmesdes types suivants :
■ licence et numéros de série des produits ;
■ mise à jour des enregistrements de produit en cas de changement de nom ou
d'adresse ;
■ informations généralessur les produits (caractéristiques, langues disponibles,
distributeurs) ;
■ dernières informations sur les mises à jour et mises à niveau des produits ;
■ informations surles assurancesde mise à jour et les contrats de maintenance ;
■ informations au sujet de l'achat de programmes Symantec ;
■ conseil sur les options de support technique de Symantec ;
■ questions avant-vente non techniques ;
■ questions concernant les CD-ROM ou les manuels.
Page 6
Ressources des accords de maintenance
Pour touteinformation sur les accords de maintenance, veuillez contacter l'équipe
administrative responsable de votre région :
contractsadmin@symantec.comAsie-Pacifique et Japon
semea@symantec.comEurope, Moyen-Orient et Afrique
supportsolutions@symantec.comAmérique du Nord et Amérique latine
Services supplémentaires destinés aux entreprises
Symantec propose un ensemble complet de services qui vous permettront de
rentabiliser aumaximum vosproduits Symantec,de développervos compétences
et d'avoir une meilleure vue d'ensemble pour gérer plus efficacement les risques
auxquels votre entreprise doit faire face.
Les services destinés aux entreprises sont les suivants :
Symantec EarlyWarning Solutions
Services de supervision de la
sécurité
Services de conseil
Services de formation
Pour accéder à des informations supplémentaires concernant les services
d'entreprise, visitez notre site Web à l'adresse :
www.symantec.com
Sélectionnez le pays et la langue de votre choix dans l'index du site.
Ces solutions permettent que vous soyez prévenu précocement en cas de
cyber-attaque et vous appuyer sur une analyse exhaustive des menaces et des
contre-mesures pour prévenir les attaques avant qu'elles ne frappent.
Ces services évitent l'obligation de gérer et superviser les périphériques et les
événements de sécurité, garantissant ainsi une réponse rapide aux menaces
réelles.
Symantec Consulting Services garantissent une expertise technique sur site
apportée directement par Symantec ou ses partenaires agréés. Symantec
Consulting Servicespropose unesérie d'optionspréconçues etpersonnalisables
qui incluent des fonctions d'évaluation, de conception, de mise en oeuvre, de
surveillance et de gestion. Chacune porte sur l'établissement et la mise à jour
de l'intégrité et de la disponibilité de vos ressources informatiques.
Les services de formations fournissent une gamme complète de programmes
de formation technique, de formation à la sécurité, de certification de sécurité
et de communication de sensibilisation.
Utilisation de
l'automatisation OLE avec
Symantec pcAnywhere
Ce chapitre traite des sujets suivants :
■ A propos de l'automatisation OLE
■ A propos du serveur d'automatisation pcAnywhere
■ Ce que vous pouvez faire avec le serveur d'automatisation pcAnywhere
1
■ Avant de commencer
■ Pour plus d'informations
A propos de l'automatisation OLE
L'automatisation OLE est une technologie qui permet de créer une application
externe ou un autre outil de développement (par exemple unscript ou une macro)
capable de contrôler et d'automatiser toute fonction exposée d'une application.
L'automatisation OLE est constituée des composants suivants :
un serveur d'automatisation
OLE ;
une application ou composant logiciel qui expose sa
fonction afin d'être accessible ou de pouvoir être contrôlé
par d'autres applications ou d'autres outils de
développement.
Le serveur d'automatisation pcAnywhere est un exemple
de serveur d'automatisation OLE ;
Page 10
Utilisation de l'automatisation OLE avec Symantec pcAnywhere
10
A propos du serveur d'automatisation pcAnywhere
un contrôleur
d'automatisation OLE ;
Une application externe accède à un serveur d'automatisation en se connectant
au serveur,puis en demandant l'accès à une ouplusieurs deses interfacespubliées.
Une interface est un point d'entrée permettant d'accéder à une ou plusieurs
méthodes ou propriétés rattachées. Une fois que l'application a obtenu une
interface vers le serveur, elle peut appeler toute méthode d'interface comme si
celle-ci faisait partie de l'application externe.
une application ou outil de développement pouvant
atteindre etcontrôler lescomposants exposéspar leserveur
d'automatisation OLE.
Vous pouvez utiliser tout langage de programmation
prenant encharge l'automatisationOLE. Lesdeux langages
de programmation les plus courants sont Microsoft Visual
Basic et Microsoft Visual C++.
A propos du serveur d'automatisation pcAnywhere
Le serveur d'automatisation pcAnywhere permet aux applications externes de
gérer les fichiers pcAnywhere Hôte et Distant afin d'automatiser les tâches de
téléintervention et de transfert de fichiers. Le serveur d'automatisation
pcAnywhere fonctionne comme un substitut programmable de l'interface
utilisateur de Symantec pcAnywhere et reprend dans une large mesure son
comportement par défaut.
Par exemple,lorsque vouscréez unobjet hôtedans pcAnywhere,le premiermodem
TAPI disponible est attribué par défaut. De même, si vous créez un objet hôte à
l'aide du serveur d'automatisation pcAnywhere, puis que vous énumérez la liste
des connexions attribuées, le premier modem TAPI disponible est déjà attribué.
Ce que vous pouvez faire avec le serveur
d'automatisation pcAnywhere
Le serveur d'automatisation pcAnywhere vous permet d'automatiser diverses
tâches administratives et de productivité.
Vous pouvez utiliser serveur d'automatisation pcAnywhere pour effectuer les
actions suivantes :
■ Distribution et installation automatiques de mises à jour logicielles sur
plusieurs ordinateurs du réseau
■ Programmation detransferts automatiques de fichiers entre ordinateurs à des
fins d'audit ou d'archivage
Page 11
■ Ajouter ou supprimer automatiquement un nom de la liste des appelants sur
chaque hôte pcAnywhere de votre réseau
Ce document comporte plusieurs exemples, écrits à la fois en Visual Basic et en
Visual C++,afin d'illustrer la manière de se connecterau serveurd'automatisation
pcAnywhere et de l'utiliser.
Se reporter à "A propos des objets Visual Basic" à la page 17.
Se reporter à "A propos des objets Visual C++" à la page 61.
Avant de commencer
Au cours d'une connexion au serveur d'automatisation pcAnywhere et à ses
interfaces, les paramètres d'identification, appelés GUID (Globally Unique
Identifiers - identificateurs globalement uniques), sont transmis aux fonctions
API de la bibliothèque d'automatisation. Un GUID distinctest attribué au serveur
d'automatisation pcAnywhere et à chaque interface exposée. Ces GUID doivent
être présents dans le registre système pour connecter une application externe au
serveur d'automatisation pcAnywhere et à ses interfaces.
Si vous exécutez l'application externe sur un ordinateur sur lequel Symantec
pcAnywhere estinstallé, vouspouvez inscrire automatiquement les entrées GUID.
Dans le cas contraire, vous devez enregistrer les entrées GUID manuellement.
Se reporter à "Inscription automatique du moteur distant" à la page 11.
Se reporter à "Inscription manuelle du moteur distant" à la page 12.
Avant de commencer
11Utilisation de l'automatisation OLE avec Symantec pcAnywhere
Inscription automatique du moteur distant
Avant de vous connecter à un autre ordinateur pour la première fois en utilisant
votre client OLE, vous devez inscrire automatiquement le moteur distant. Cette
opération peut s'effectuer automatiquement lorsque vous démarrez un objet
distant dans Symantec pcAnywhere.
Pour inscrire automatiquement le moteur distant
Pour ouvrirSymantec pcAnywhere, effectuez l'une des opérations suivantes :
1
■ Sur le bureau, cliquez deux fois sur l'icône du programme Symantec
pcAnywhere.
Page 12
Utilisation de l'automatisation OLE avec Symantec pcAnywhere
12
Avant de commencer
■ Dans la barre des tâches de Windows, cliquez sur Démarrer>
Programmes> Symantec pcAnywhere.
Dans la fenêtre du Gestionnaire pcAnywhere, cliquez sur Distants.
2
Cliquez deux fois sur un élément de connexion distante.
3
Cette procédure inscrit le moteur distant. Il n'est pas nécessaire de terminer
la connexion.
Inscription manuelle du moteur distant
Si pcAnywhere n'est pas installé sur l'ordinateur sur lequel vous exécutez
l'application externe, vous devez inscrire manuellement les GUID en exécutant
le fichier exécutable (winawsvr.exe) du serveur d'automatisation pcAnywhere. Il
suffit de lancer l'exécutable une seule fois pour ajouter les GUID au registre. Le
fichier Winawsvr.exe se trouve dans le répertoire d'installation.
Accès au serveur d'automatisation pcAnywhere
Vous pouvez accéder au serveur d'automatisation de pcAnywhere en utilisant
toute plate-formeprenant encharge l'automatisation OLE. Les deux plates-formes
les plusrépandues quiprennent en charge l'automatisation OLE sont Visual Basic
et Visual C++.
Les principes de codage de ces deux plates-formes sont similaires, bien que dans
l'environnement Visual Basic une part importante des tâches de bas niveau est
exécutée en arrière-plan par l'exécutable Visual Basic.
Accès au serveur d'automatisation pcAnywhere avec Visual Basic
Le langage de programmation Visual Basic intègre la prise en charge de
l'interaction avec les serveurs d'automatisation OLE tels que le serveur
d'automatisation pcAnywhere. Vous pouvez créer un projet Exe standard puis,
dans chaque méthode, entrer le code pour accéder au serveur d'automatisation
pcAnywhere. Visual Basic prend les appels de méthode de haut niveau dans les
fichiers source et les développe de façon interne dans les appels de méthode de
bas niveau correspondants de l'automatisation OLE.
Page 13
Avant de commencer
Pour accéder au serveur d'automatisation pcAnywhere avec Visual Basic
Ajoutez une paire de variables objet pour chaque objet pcAnywhere auquel
1
accéder.
Par exemple, pour travailler avec des objets distant, dimensionnez un objet
Visual Basic utilise le paramètre textuel pour repérer l'identificateur du
gestionnaire dans la base de registres et renvoie l'interface vers ce
gestionnaire.
Une fois qu'il existe un objet gestionnaire de données valide, utilisez-le pour
3
effectuer les opérations suivantes :
■ Déterminer le répertoire en cours
■ Accéder à un autre répertoire
■ Enumérer lesfichiers objet de données associés dans le répertoire encours
13Utilisation de l'automatisation OLE avec Symantec pcAnywhere
■ Créer, extraire ou supprimer un fichier objet de données
Après la création ou la récupération d'un objet de données, vous pouvez
4
obtenir (Get) ou définir (Set) ses propriétés.
La syntaxede Visual Basic n'utilise pas de nom de propriété pour différencier
l'obtention et la définition de sa valeur. C'est la position de la propriété par
rapport à l'opérateur d'affectation qui détermine si l'appel de méthode
sous-jacent est un Get ou un Set.
Les exemples suivants illustrent un Get et un Set :
■ Pour obtenir la valeur du numéro de téléphone d'un objet, placez le nom
de la propriété à droite de l'opérateur d'affectation.
Par exemple, s = RemoteData.PhoneNumber(), où s est une variable de
type chaîne.
■ Pour configurer le numéro de téléphone, placez le nom de la propriété à
gauche de l'opérateur d'affectation.
Par exemple, RemoteData.PhoneNumber = "555-1212"
Page 14
Utilisation de l'automatisation OLE avec Symantec pcAnywhere
14
Avant de commencer
Accès au serveur d'automatisation pcAnywhere avec Visual C++
Le serveur d'automatisation pcAnywhere utilise des bibliothèques de type pour
exposer lesinformations concernant ses interfaces et ses méthodes vers lesclients
d'automatisation, quisont écrits en Visual C++. Ces bibliothèquesde type utilisent
des MFC (Microsoft Foundation Classes), qui peuvent être importées dans votre
application via l'assistant ClassWizard de Visual C++.
Les classes du gestionnaire de données fournies dans les bibliothèques de type
contiennent la fonction nécessaire pour obtenir une interface vers le serveur
d'automatisation pcAnywhere et effectuer des opérations de haut niveau sur le
type d'objet associé à l'interface.
Utiliser l'objet gestionnaire de données pour effectuer les opérations suivantes :
■ Déterminer ou modifier le répertoire en cours.
■ Enumérer les fichiers objet de données du répertoire en cours.
■ Créer, extraire ou supprimer un objet nommé.
Une fois créé ou récupéré, un objet utilise la classe d'objet de données associée
pour examiner ou modifier ses propriétés exposées. La plupart de ces propriétés
sont exposées à travers une paire de méthodes qui commencent par le mot Get
ou Set. Par exemple, un utilisateur appelle la méthode GetPhoneNumber pour
examiner la propriété de numéro de téléphone en cours de l'objet et appelle
SetPhoneNumber pour la définir.
Importation et affichage des classes
Le serveur d'automatisation pcAnywhere utilise les bibliothèques de type
suivantes :
Winawsvr.tlb
Awrem32.tlb
Les procéduressuivantes expliquent comment importer les bibliothèques detype
du serveurd'automatisation pcAnywhere et afficher les classes ayantété ajoutées
à votre application.
Pour importer des classes
Créez une application MFC dans Visual C++.
1
Dans le menu Affichage, cliquez sur Assistant de classe.
2
Contient les informations nécessaires pour se connecter au serveur
d'automatisation pcAnywhere et accéder à ses interfaces.
Contient les informations nécessaires au contrôle des connexions
pcAnywhere.
Page 15
Avant de commencer
Dans la boîte de dialogue Assistant de classe, cliquez sur Ajouterune classe,
3
puis cliquez sur Depuis une bibliothèque de type.
Cliquez deux fois sur winawsvr.tlb.
4
Dans la boîte de dialogue Confirmer Classes, cliquez sur OK pour importer
5
toutes les définitions de classe.
Dans la boîte de dialogue Assistant de classe, cliquez sur Ajouterune classe,
6
puis cliquez sur Depuis une bibliothèque de type.
Cliquez deux fois sur awrem32.tlb.
7
Dans la boîte de dialogue Confirmer Classes, cliquez sur OK pour importer
8
toutes les définitions de classe.
Dans la boîte de dialogue Assistant de classe, cliquez sur OK pour terminer
9
l'importation.
Les classes sont ajoutées à l'application. Elles vous permettent de manipuler
des objets et de gérer des connexions.
L'importation des définitions de classe à partir des bibliothèques de type
ajoute également des fichiers de prise en charge à l'application. Ces fichiers
contiennent les définitions de classe et le code source de mise en oeuvre du
serveur d'automatisation pcAnywhere.
Se reporter à "Affichage des définitions de classe et des fichiers de mise en
oeuvre" à la page 15.
Pour afficher les classes ajoutées
15Utilisation de l'automatisation OLE avec Symantec pcAnywhere
Dans Visual C++, ouvrez votre application MFC.
1
Dans la fenêtre de l'espace de travail, cliquez sur l'onglet ClassView.
2
Affichage des définitions de classe et des fichiers de mise en
oeuvre
Lorsque vous importez les bibliothèques de type du serveur d'automatisation
pcAnywhere dans votre application, les fichiers suivants sont ajoutés :
■ Winawsvr.h
■ Winawsvr.cpp
■ Awrem32.h
■ Awrem32.cpp
Ces fichiers contiennent les définitions de classe et le code source de mise en
oeuvre duserveur d'automatisation pcAnywhere. Il est inutile d'éditerces fichiers;
Page 16
Utilisation de l'automatisation OLE avec Symantec pcAnywhere
16
Pour plus d'informations
cependant, chaque fichier source de l'application contenant des appels des
méthodes du serveur d'automatisation pcAnywhere doit inclure Winawsvr.h.
Pour afficher les définitions de classe et les fichiers de mise en oeuvre
Dans Visual C++, ouvrez votre application MFC.
1
Dans la fenêtre de l'espace de travail, cliquez sur l'onglet FileView.
2
Démarrage des objets OLE hôte et distant
Symantec pcAnywhere nécessite que tous les objetshôte et distant soient stockés
dans le répertoire de données par défaut. Avant de démarrer un objet hôte ou
distant que vous avez créé avec OLE, vérifiez qu'il se trouve dans le répertoire de
données par défaut de pcAnywhere. Le répertoire par défaut est le dossier All
Users dans Windows XP, et le dossier ProgramData dans Vista.
Pour plus d'informations
Pour plus d'informations sur l'automatisationOLE, reportez-vousaux documents
de référence suivants (en anglais) :
■ Rogerson, Dale. 1997. Inside COM. Redmond, Wash.: Microsoft Press.
■ Templeman, Julian. 1997. Beginning MFC COM Programming. Birmingham,
RU : Wrox Press.
Page 17
Chapitre
Définitions d'objets Visual
Basic
Ce chapitre traite des sujets suivants :
■ A propos des objets Visual Basic
■ Méthodes CRemoteDataManager
■ Propriétés CRemoteData
■ objet CRemoteDataEx
2
■ Méthodes CHostDataManager
■ Propriétés CHostData
■ objet CHostDataEx
■ fonctions awrem32
A propos des objets Visual Basic
Le serveur d'automatisation pcAnywhere offre les composants suivants pour la
prise en charge de l'automatisation OLE :
Winawsvr
Awrem32
Le Tableau 2-1 décrit les objets qui composent Winawsvr.
contient les informations nécessaires pour se connecter au serveur
d'automatisation pcAnywhere et accéder à ses interfaces.
Contient les informations nécessaires au contrôle des connexions
pcAnywhere.
Page 18
Définitions d'objets Visual Basic
18
Méthodes CRemoteDataManager
CRemoteDataManager
CRemoteData
CHostDataManager
CHostData
Tableau 2-1
Objets Winawsvr
RéférenceDescriptionObjet
Fournit les méthodes pour créer, ouvrir,
modifier, enregistrer et supprimer les
objets CRemoteData.
Définit les paramètres permettant
d'accéder à la fonction distant de
pcAnywhere et de la contrôler.
Fournit les méthodes pour créer, ouvrir,
modifier, enregistrer et supprimer les
objets ChostData.
Définit les paramètres permettant
d'accéder àla fonctionhôte depcAnywhere
et de la contrôler.
Se reporter à "Méthodes
CRemoteDataManager" à la page 18.
Se reporter à "Propriétés CRemoteData"
à la page 21.
Se reporter à "objet CRemoteDataEx"
à la page 31.
Se reporter à "Méthodes
CHostDataManager" à la page 34.
Se reporter à "Propriétés CHostData"
à la page 37.
Se reporter à "objet CHostDataEx"
à la page 48.
Awrem32 possède un objet, constitué de huit interfaces, pour prendre en charge
les sessions de téléintervention et de transfert de fichiers.
Se reporter à "fonctions awrem32" à la page 58.
Quelques fonctions ne sont plus prises en charge. Cependant, les définitions
d'objets sont utilisables avec les versions antérieures de pcAnywhere.
Pour les fonctions nécessitant des mots de passe, les valeurs des mots de passe
peuvent être définies mais non récupérées, pour des raisons de sécurité.
Méthodes CRemoteDataManager
Les méthodes CRemoteDataManager fournissent les paramètres et renvoient les
valeurs permettant d'accéder aux objets CRemoteData et de les contrôler.
Tableau 2-2
Méthode
CRemoteDataManager
CurrentDirectory()
Méthodes CRemoteDataManager
renvoyés
Valeur renvoyée =
chaîne
DescriptionParamètre ou valeur
Renvoie le chemin d'accès complet
du dossier actuel dans lequel les
objets distants pcAnywhere sont
stockés.
Page 19
Méthodes CRemoteDataManager
19Définitions d'objets Visual Basic
Méthode
CRemoteDataManager
ChangeDirectory(nouveau
répertoire)
FindFirst(schéma)
FindFirst(nom)
FindNext(nom)
FindNext(nom)
renvoyés
Paramètre =
NewDirectory
Paramètre =schéma en
tant que chaîne
Paramètre = Nom
comme chaîne
Paramètre = Nom
comme chaîne
Valeur renvoyée =
booléen
DescriptionParamètre ou valeur
Change ledossier actueldans lequel
les objetsdistants pcAnywheresont
stockés.
Trouve le premier fichier d'objet
distant de pcAnywhere (*.chf) dans
le rdossieren cours; classeles noms
de fichiers de schémas sur base du
schéma spécifié de nom de fichier
(un astérisque[*] permet detrouver
tous lesfichiers dudossier encours)
Tampon de retour pour le chemin
d'accès complet du fichier d'objet
distant (*chf) correspondant au
schéma spécifié
Tampon de retour pour le chemin
d'accès complet du fichier d'objet
distant correspondant au schéma
spécifié dans l'appel initial de
FindFirst().
VRAI si un autre fichier d'objet
distant correspondant au schéma
spécifié dans l'appel de FindFirst()
est trouvé. Le chemin d'accès
complet du fichier est stocké dans
Nom.
RetrieveObject(nom)
RetrieveObject(mode
d'accès)
RetrieveObject(mot de
passe)
Paramètre = Nom
comme chaîne
Paramètre = Mode
d'accès comme valeur
entière
Paramètre = Mot de
passe comme chaîne
Nom intégralement qualifié du
fichier d'objet distant à charger.
Spécifie commentcet objetdoit être
utilisé. Ce paramètre est lié à la
protection par mot de passe.
Les options sont les suivantes :
■ 0 = Non spécifié
■ 1 = Afficher uniquement
■ 2 = Afficher et modifier
■ 3 = Exécuter
Mot de passe de l'objet. Peut être
NULL.
Page 20
Définitions d'objets Visual Basic
20
Méthodes CRemoteDataManager
Méthode
CRemoteDataManager
RetrieveObjectEx(nom)
RetrieveObjectEx(mode
d'accès)
RetrieveObjectEx(mot de
passe)
RetrieveObjectEx
CreateObject(nom)
renvoyés
Paramètre = Nom
comme chaîne
Paramètre = Mode
d'accès comme valeur
entière
Paramètre = Mot de
passe comme chaîne
Valeur renvoyée =
Objet
Paramètre = Nom
comme chaîne
DescriptionParamètre ou valeur
Nom intégralement qualifié du
fichier d'objet distant à charger.
Spécifie commentcet objetdoit être
utilisé. Ce paramètre est lié à la
protection par mot de passe.
Les options sont les suivantes :
■ 0 = Non spécifié
■ 1 = Afficher uniquement
■ 2 = Afficher et modifier
■ 3 = Exécuter
Mot de passe de l'objet. Peut être
NULL.
Objet CRemoteDataEx du fichier
spécifié.
Crée un objet CRemoteData et
renvoie un pointeur LPDISPATCH
qui le désigne. Le paramètre est le
nom defichier entièrementqualifié
d'objet distant pour le nouvel objet.
CreateObject
CreateObjectEx(nom)
CreateObjectEx
DeleteObject(nom)
DeleteObject(mot de passe)
DeleteObject
Objet
Paramètre = Nom
comme chaîne
Objet
Paramètre = Nom
comme chaîne
passe comme chaîne
booléen
CRemoteDataValeur renvoyée =
Crée un objet CRemoteDataEx et
renvoie un pointeur LPDISPATCH
qui le désigne. Le paramètre est le
nom defichier entièrementqualifié
d'objet distant pour le nouvel objet.
CRemoteDataExValeur renvoyée =
Nom intégralement qualifié du
fichier d'objet distant de l'objet à
supprimer.
Mot de passe de l'objetParamètre = Mot de
VRAI si l'objet est supprimé.Valeur renvoyée =
Page 21
Propriétés CRemoteData
Les propriétéset lesparamètres disponiblespour l'objet CRemoteData sont affichés
comme suit.
Dans Tableau 2-3, remplacez les informations entre les chevrons par les valeurs
réelles.
Propriétés CRemoteData
21Définitions d'objets Visual Basic
Tableau 2-3
CRemoteData - Propriétés et paramètres
DescriptionParamètrePropriété
Chaîne<CRemoteData>.ComputerName(chaîne)
Chaîne<CRemoteData>.PhoneNumber(chaîne)
Bool<CRemoteData>.UseDialingProperties(Bool)
Entier<CRemoteData>.RedialCount(entier)
Entier<CRemoteData>.RedialDelay(entier)
Chaîne<CRemoteData>.AutoLoginName(chaîne)
Chaîne<CRemoteData>.AutoLoginPassword(chaîne)
Définit le nom ou l'adresse IP de l'ordinateur
hôte.
Définit lenuméro detéléphone del'ordinateur
hôte.
Définit les propriétés de numérotation du
système.
Définit lenombre detentatives derappel avant
l'annulation de l'appel.
Définit le nombre de secondes d'attente entre
les tentatives de rappel.
Définit le nom de l'utilisateur pour la
connexion automatique.
Pour plusd'informations surl'utilisation de la
connexion aux domaines, reportez-vous à la
section :
Se reporter à "objet CRemoteDataEx"
à la page 31.
Définit le mot de passe pour la connexion
automatique dans l'objet distant.
Pour des raisons de sécurité, le serveur
d'automatisation pcAnywhere ne permet pas
de lire la valeur du mot de passe. Aucune
valeur de mot de passe n'est renvoyée.
Page 22
Définitions d'objets Visual Basic
22
Propriétés CRemoteData
DescriptionParamètrePropriété
Chaîne<CRemoteData>.Password(chaîne)
Bool<CRemoteData>.ExecuteProtection (Bool)
Bool<CRemoteData>.ReadProtection(Bool)
Bool<CRemoteData>.WriteProtection(Bool)
Bool<CRemoteData>.LogSession (Bool)
Chaîne<CRemoteData>.RecordFile(chaîne)
Bool<CRemoteData>.RecordSession(Bool)
Définit le mot de passe sur l'objet distant, à
utiliser avec les méthodes ExecuteProtection,
ReadProtection et WriteProtection.
Pour des raisons de sécurité, le serveur
d'automatisation pcAnywhere ne permet pas
de lire la valeur du mot de passe. Aucune
valeur de mot de passe n'est renvoyée.
Définit la nécessité d'un mot de passe pour
exécuter l'objet. Définir par mot de passe.
Définit la nécessité d'un mot de passe pour
afficher lespropriétés del'objet distant.Définir
par mot de passe.
Définit la nécessité d'un mot de passe pour
enregistrer les modification de l'objet distant.
Définir par mot de passe.
Active et désactive la consignation des
sessions.
Définit le nom et le chemin d'accès
intégralement qualifié du fichier
d'enregistrement de la session active.
Active et désactive la consignation
automatique de session.
Chaîne<CRemoteData>.ReadObject(chaîne)
Chaîne<CRemoteData>.WriteObject(chaîne)
Définit le mot de passe de l'objet. Utilisez cette
propriété pour actualiser la copie locale des
données de l'objet distant.
Définit le mot de passe de l'objet. Utilisez cette
propriété pour créer l'objet distant ou pour
écrire les changements apportés à celui-ci.
Les propriétés et les valeurs renvoyées pour CRemoteData sont affichées dans le
tableau suivant.
Dans Tableau 2-4, remplacez les informations entre les chevrons par les valeurs
réelles.
Page 23
Propriétés CRemoteData
23Définitions d'objets Visual Basic
Propriété
Tableau 2-4
CRemoteData - Propriétés et valeurs renvoyées
DescriptionValeur
renvoyée
ChaîneString = <CRemoteData>.ComputerName
ChaîneString = <CRemoteData>.PhoneNumber
BoolBool = <CRemoteData>.UseDialingProperties
EntierInteger = <CRemoteData>.RedialCount
EntierInteger = <CRemoteData>.RedialDelay
ChaîneString = <CRemoteData>.AutoLoginName
BoolBool = <CRemoteData>.ExecuteProtection
BoolBool = <CRemoteData>.ReadProtection
Renvoie le nom ou l'adresse IP de l'ordinateur
hôte
Renvoie lenuméro detéléphone del'ordinateur
hôte
Renvoie les propriétés de numérotation du
système définies dans l'objet distant
Renvoie lenombre de tentativesd'appel défini
dans l'objet distant
Renvoie lenombre desecondes d'attenteentre
les tentatives de rappel.
Renvoie le nom de l'utilisateur pour la
connexion automatique
Renvoie la valeur du paramètre
ExecuteProtection.
Renvoie la valeur du paramètre
ReadProtection.
BoolBool = <CRemoteData>.WriteProtection
ChaîneString = <CRemoteData>.RecordFile
BoolBool = <CRemoteData>.RecordSession
Propriétés du type de connexion
Le tableau suivant décrit les propriétés et les paramètres du type de connexion.
Dans Tableau 2-5, remplacez les informations entre les chevrons par les valeurs
réelles.
Renvoie la valeur du paramètre
WriteProtection
VRAI si la consignation de session est activée.BoolBool = <CRemoteData>.LogSession
Renvoie le nom et le chemin d'accès
intégralement qualifié du fichier
d'enregistrement de la session.
Renvoie la valeur du paramètre
d'enregistrement de session.
Page 24
Définitions d'objets Visual Basic
24
Propriétés CRemoteData
Tableau 2-5
Type de connexion - Propriétés et paramètres
DescriptionParamètrePropriété
Chaîne<CRemoteData>.ConnectionType(chaîne)
Définit le type de connexion de l'ordinateur
distant. La valeur transmise doit être un type
de connexion valide, défini par les fonctions
FirstConnectionType() et
NextConnectionType().
Les types suivants sont des exemples de
connexions valides :
■ COM1
■ COM2
■ COM3
■ COM4
■ TCP/IP
■ SPX
■ NetBIOS
■ RNIS via CAPI 2.0
■ Nom du modem (tel qu'il apparaît sur
l'ordinateur)
Le tableau suivant décrit les propriétés et les valeurs renvoyées pour le type de
connexion.
Dans Tableau 2-6, remplacez les informations entre les chevrons par les valeurs
réelles.
Propriété
Tableau 2-6
Type de connexion - Propriétés et valeurs renvoyées
Renvoie le nombre de types de connexion
disponibles.
Les types suivants sont des exemples de
connexions valides :
■ COM1
■ COM2
■ COM3
■ COM4
■ TCP/IP
■ SPX
■ NetBIOS
■ RNIS via CAPI 2.0
■ Nom du modem (tel qu'il apparaît sur
l'ordinateur)
Renvoie le premier type de connexion
disponible.
Renvoie le type de connexion disponible
suivant. L'appel s'effectue de façon
séquentielle pour le nombre de types de
connexion défini dans
<CRemoteData>.ConnectionType, afin
d'énumérer tous les types de connexion.
de connexion)
Propriétés de numérotation
Le tableausuivant décrit les propriétés et les paramètrespour définirles propriétés
de numérotation pour les connexions par modem.
Dans Tableau 2-7, remplacez les informations entre les chevrons par les valeurs
réelles.
BoolBool =<CRemoteData>.FindConnectionType(type
VRAI si le type de connexion indiqué a été
trouvé dans la liste des types de connexion
disponibles.
Page 26
Définitions d'objets Visual Basic
26
Propriétés CRemoteData
Propriété
Tableau 2-7
Propriétés de numérotation - Propriétés et paramètres
DescriptionParamètrePropriété
Chaîne<CRemoteData>.AreaCode(chaîne)
Chaîne<CRemoteData>.CountryCode(chaîne)
Définit lespropriétés denumérotation decode
de zone pour les connexions par modem
Définit les propriétés de numérotation
d'indicatif international pour les connexions
par modem
Le tableausuivant définit les propriétés et les valeursrenvoyées pourles propriétés
de numérotation par modem.
Dans Tableau 2-8, remplacez les informations entre les chevrons par les valeurs
réelles.
Tableau 2-8
Propriétés de numérotation - Propriétés et valeurs renvoyées
DescriptionValeur
renvoyée
ChaîneString = <CRemoteData>.AreaCode
ChaîneString= <CRemoteData>.CountryCode
EntierInteger = <CRemoteData>.CountryCodes
Renvoie lespropriétés denumérotation de code
de zone
Renvoie les propriétés de numérotation
d'indicatif international
Le tableau suivant définit les propriétés et les paramètres qui vous permettent
de personnaliserles paramètres de port du modem etdes autresconnexions COM.
Dans Tableau 2-9, remplacez les informations entre les chevrons par les valeurs
réelles.
Renvoie le premier indicatif de pays
apparaissant dans la liste du système
d'exploitation.
Renvoie l'indicatif international disponible
suivant. L'appel s'effectue de façon
séquentielle pour le nombre d'indicatifs
internationaux défini dans
<CRemoteData.CountryCodes>, afin
d'énumérer tousles indicatifs internationaux.
Page 27
Propriétés CRemoteData
27Définitions d'objets Visual Basic
Tableau 2-9
Périphérique COM - Propriétés et paramètre
DescriptionParamètrePropriété
Chaîne<CRemoteData>.ComParity(chaîne)
Chaîne<CRemoteData>.ComFlowControl(chaîne)
Chaîne<CRemoteData>.ComStartedBy(chaîne)
Définit la parité des communications.
Les valeurs suivantes sont valides :
■ <Aucun>
■ Impaire
■ Paire
■ Marque
■ Espace
Définit le contrôle de flux des types de
connexion COM.
Les valeurs suivantes sont valides :
■ <Aucune>
■ XONXOFF
■ RTS/CTS
■ Les deux
Définit le paramètre de début des types de
connexion COM.
Les valeurs suivantes sont valides :
■ Toujours connecté
■ Détection de porteuse (DCD)
■ Prêt à émettre (CTS)
■ Ensemble de données prêt (DSR)
■ Signal de sonnerie (RI)
■ Réception 2 <RC>
■ Réponse du modem
Chaîne<CRemoteData>.ComEndedBy(chaîne)
Définit le paramètre de fin des types de
connexion COM.
Les valeurs suivantes sont valides :
■ Toujours connecté
■ Détection de porteuse (DCD)
■ Prêt à émettre (CTS)
■ Ensemble de données prêt (DSR)
■ Signal de sonnerie (RI)
Page 28
Définitions d'objets Visual Basic
28
Propriétés CRemoteData
DescriptionParamètrePropriété
Propriété
Long<CRemoteData>.ComSpeed(Long)
Contient le paramètre de vitesse COM
maximale
Les valeurs suivantes sont valides :
■ 110
■ 300
■ 600
■ 1200
■ 2400
■ 4800
■ 9600
■ 38400
■ 57600
■ 115200
Le tableausuivant décrit les propriétés et les valeursrenvoyées parle périphérique
COM.
Dans Tableau 2-10, remplacez les informations entre les chevrons par lesvaleurs
réelles.
Tableau 2-10
Périphériques COM - Propriétés et valeurs renvoyées
DescriptionValeur
renvoyée
ChaîneString = <CRemoteData>.ComParity
Renvoie l'une des valeurs suivantes comme
parité de communications :
■ <Aucune>
■ Impaire
■ Paire
■ Marque
■ Espace
ChaîneString = <CRemoteData>.ComFlowControl
Renvoie le paramètre de contrôle de flux de
l'objet distant.
Les valeurs suivantes sont valides :
■ <Aucun>
■ XONXOFF
■ RTS/CTS
■ Les deux
Page 29
Propriétés CRemoteData
29Définitions d'objets Visual Basic
Propriété
renvoyée
ChaîneString = <CRemoteData>.ComStartedBy
ChaîneString = <CRemoteData>.ComEndedBy
LongLong = <CRemoteData>.ComSpeed
DescriptionValeur
Renvoie le contrôle de début des types de
connexion COM.
Les valeurs suivantes sont valides :
■ Toujours connecté
■ Détection de porteuse (DCD)
■ Prêt à émettre (CTS)
■ Ensemble de données prêt (DSR)
■ Signal de sonnerie (RI)
■ Réception 2 <RC>
■ Réponse du modem
Renvoie le contrôle de fin des types de
connexion COM
Les valeurs suivantes sont valides :
■ Toujours connecté
■ Détection de porteuse (DCD)
■ Prêt à émettre (CTS)
■ Ensemble de données prêt (DSR)
■ Signal de sonnerie (RI)
Renvoie le paramètre de vitesse de
communication de l'objet distant
Les valeurs suivantes sont valides :
■ 110
■ 300
■ 600
■ 1200
■ 2400
■ 4800
■ 9600
■ 38400
■ 57600
■ 115200
Propriétés de périphérique NetBIOS
Le tableausuivant définit les propriétés et les paramètres d'un périphériqueréseau
NetBIOS.
Page 30
Définitions d'objets Visual Basic
30
Propriétés CRemoteData
Dans Tableau 2-11, remplacez les informations entre les chevrons par lesvaleurs
réelles.
Tableau 2-11
NetBIOS - Propriétés et paramètres
DescriptionParamètrePropriété
Entier<CRemoteData>.LanaNumber(entier)
Définit lenuméro d'adaptateurréseau (LANA)
à utiliser pour les connexions NetBIOS.
Le tableau suivant définit les propriétés et les valeurs renvoyées par NetBIOS.
Dans Tableau 2-12, remplacez les informations entre les chevrons par lesvaleurs
réelles.
Tableau 2-12
Propriété
Propriété NetBIOS et valeur renvoyée
DescriptionValeur
renvoyée
EntierInteger = <CRemoteData>.LanaNumber
Renvoie le paramètre en cours du numéro
LANA pour les connexions NetBIOS.
Propriétés de périphérique RNIS via CAPI 2.0
Le tableau suivant définit les propriétés et les paramètres pour les connexions
RNIS européennes.
Dans Tableau 2-13, remplacez les informations entre les chevrons par lesvaleurs
réelles.
Tableau 2-13
RNIS via CAPI 2.0 - Propriétés et paramètres
DescriptionParamètrePropriété
Bool<CRemoteData>.CapiChannelBonding(Bool)
Chaîne<CRemoteData>.CapiExtensions(chaîne)
Active ou désactive la liaison de canaux pour
les périphériques RNIS CAPI.
Définit toute extension CAPI supplémentaire
nécessaire pour les communications.
Le tableau suivant définit les propriétés et les valeurs renvoyées pour les
connexions RNIS européennes.
Dans Tableau 2-14, remplacez les informations entre les chevrons par lesvaleurs
réelles.
Page 31
objet CRemoteDataEx
31Définitions d'objets Visual Basic
Tableau 2-14
RNIS via CAPI 2.0 - Propriétés et valeurs renvoyées
Propriété
objet CRemoteDataEx
L'objet CRemoteDataExcontient la même fonctionnalité quel'objet CRemoteData
avec une fonctionnalité supplémentaire.
Le tableau suivant décrit les propriétés et les paramètres.
Dans Tableau 2-15, remplacez les informations entre les chevrons par lesvaleurs
réelles.
Tableau 2-15
CRemoteDataEx - Paramètres
renvoyée
BoolBool= <CRemoteData>.CapiChannelBonding
ChaîneString = <CRemoteData>.CapiExtensions
Chaîne<CRemoteData>.PrivateKey (chaîne)
DescriptionValeur
Renvoie le paramètre de liaison de canaux
RNIS CAPI en cours dans l'objet distant.
Renvoie la liste actuelle des extensions CAPI
à partir de l'objet distant.
DescriptionParamètrePropriété
Définit le nom du conteneur de clé privée à
utiliser
Chaîne<CRemoteData>.CertificateName(chaîne)
Octet<CRemoteData>.AutoLoginPassword(octet)
Bool<CRemoteData>.DenyLowerEncrypt(Bool)
Chaîne<CRemoteData>.AutoDomain(chaîne)
Définit le nom commun de la clé privée à
utiliser.
Définit le niveau de chiffrement.
Les valeurs suivantes sont valides :
■ -1: Aucun
■ 0: pcAnywhere
■ 1: Symétrique
■ 2: Clé publique
Définit si l'ordinateur distant autorise une
connexion à un ordinateur hôte utilisant un
niveau de chiffrement inférieur.
Définit lenom dedomaine pourles connexions
automatiques. Cette option s'utilise avec les
types d'authentification NT et Windows.
Page 32
Définitions d'objets Visual Basic
32
objet CRemoteDataEx
Le tableau suivant décrit les propriétés et les valeurs renvoyées pour l'objet
CRemoteDataEx.
Dans Tableau 2-16, remplacez les informations entre les chevrons par lesvaleurs
réelles.
Propriété
Tableau 2-16
CRemoteDataEx - Propriétés et valeurs renvoyées
DescriptionValeur
renvoyée
ChaîneString = <CRemoteData>.PrivateKey
ChaîneString = <CRemoteData>.CertificateName
OctetByte = <CRemoteData>.EncryptionLevel
BoolBool = <CRemoteData>.DenyLowerEncrypt
ChaîneString = <CRemoteData>.AutoDomain
Renvoie le nom du conteneur de clé privée
actuellement actif
Renvoie le nom commun du conteneur de clé
privée actif.
Renvoie l'un des paramètres de chiffrement
suivants :
■ -1: Aucun
■ 0: pcAnywhere
■ 1: Symétrique
■ 2: Clé publique
Renvoie la valeur du paramètre de rejet de
niveau de chiffrement inférieur.
Renvoie leparamètre de nom dedomaine pour
les connexions automatiques. Cette option
s'utilise avec les types d'authentification NT
et Windows.
Exemple de code Visual Basic pour la fonction distant
L'exemple de code Visual Basic suivant récupère un objet de données Distant et
modifie ses propriétés.
Private Sub Command1_Click()
Dim RemoteDataManager as Object
Dim RemoteData as Object
Dim s as string
''créer un objet CRemoteDataManager
Set RemoteDataManager = CreateObject(WINAWSVR.REMOTEDATAMANAGER)
Set RemoteData = RemoteDataManager.CreateObject("test")
RemoteData.ConnectionType = "TCP/IP"
RemoteData.ComputerName = "Host1"
s = RemoteData.ConnectionType
MsgBox (s)
s = RemoteData.ComputerName
MsgBox (s)
RemoteData.WriteObject (0)
End Sub
Méthodes CHostDataManager
Les méthodes CHostDataManager fournissent les paramètres et les valeurs
renvoyées pour accéder aux objets CHostData et les contrôler.
Méthode
CHostDataManager
CurrentDirectory()
valeur
renvoyés
Valeur renvoyée
= chaîne
DescriptionParamètre ou
Nom completde chemin d'accèsau dossier de
données pcAnywhereen coursdans lequelles
objets hôte pcAnywhere sont enregistrés.
Page 35
Méthodes CHostDataManager
35Définitions d'objets Visual Basic
Méthode
CHostDataManager
FindFirst(schéma)
FindFirst(nom)
FindFirst
FindNext(nom)
FindNext
RetrieveObject(nom)
valeur
renvoyés
Paramètre =
schéma en tant
que chaîne
Paramètre =
Nom comme
chaîne
Valeur renvoyée
= booléen
Paramètre =
Nom comme
chaîne
Valeur renvoyée
= booléen
Paramètre =
Nom comme
chaîne
DescriptionParamètre ou
Schéma de nom de fichier pour filtrer les
fichiers d'objet (un astérisque [*] trouve tous
les fichiers dans le répertoire en cours).
Tampon de retour pour le chemin d'accès
complet dufichier d'objethôte correspondant
au schéma spécifié.
VRAI siun fichier d'objethôte correspondant
au schéma spécifié est trouvé. Le chemin
d'accès complet du fichier est stocké dans
Nom.
Tampon de retour pour le chemin d'accès
complet du fichier d'objet distant
correspondant auschéma spécifiédans l'appel
initial de FindFirst().
VRAI si un autre fichier d'objet hôte
correspondant auschéma spécifiédans l'appel
de FindFirst() est trouvé. Le chemin d'accès
complet du fichier est stocké dans Nom.
Nom intégralementqualifié dufichier d'objet
hôte à charger.
RetrieveObject(mode
d'accès)
RetrieveObject(mot de
passe)
RetrieveObject
Paramètre =
Mode d'accès
comme valeur
entière
de passe comme
chaîne
= Objet
Spécifie comment cet objet doit être utilisé.
Ce paramètre est lié à la protection par mot
de passe. Les options sont les suivantes :
■ 0 = Non spécifié
■ 1 = Afficher uniquement
■ 2 = Afficher et modifier
■ 3 = Exécuter
Mot de passe de l'objet. Peut être NULL.Paramètre =Mot
Objet CHostData du fichier spécifiéValeur renvoyée
Page 36
Définitions d'objets Visual Basic
36
Méthodes CHostDataManager
Méthode
CHostDataManager
RetrieveObjectEx(nom)
RetrieveObjectEx(mode
d'accès)
RetrieveObjectEx(mot de
passe)
RetrieveObjectEx
CreateObject(nom)
valeur
renvoyés
Paramètre =
Nom comme
chaîne
Paramètre =
Mode d'accès
comme valeur
entière
de passe comme
chaîne
= Objet
Paramètre =
Nom comme
chaîne
DescriptionParamètre ou
Nom intégralementqualifié dufichier d'objet
hôte à charger.
Spécifie comment cet objet doit être utilisé.
Ce paramètre est lié à la protection par mot
de passe.
Les options sont les suivantes :
■ 0 = Non spécifié
■ 1 = Afficher uniquement
■ 2 = Afficher et modifier
■ 3 = Exécuter
Mot de passe de l'objet. Peut être NULL.Paramètre =Mot
Objet CHostDataEx du fichier spécifiéValeur renvoyée
Crée un objet CHostData et renvoie un
pointeur LPDISPATCH qui le désigne. Le
paramètre est le nom de fichier entièrement
qualifié d'objet distant pour le nouvel objet.
CreateObject
CreateObjectEx(nom)
CreateObjectEx
DeleteObject(nom)
DeleteObject(mot de
passe)
= Objet
Paramètre =
Nom comme
chaîne
= Objet
Paramètre =
Nom comme
chaîne
de passe comme
chaîne
CHostDataValeur renvoyée
Crée un objet CHostDataEx et renvoie un
pointeur LPDISPATCH qui le désigne. Le
paramètre est le nom de fichier entièrement
qualifié d'objet distant pour le nouvel objet.
CHostDataExValeur renvoyée
Nom intégralementqualifié dufichier d'objet
hôte de l'objet à supprimer.
Mot de passe de l'objetParamètre =Mot
Page 37
Propriétés CHostData
37Définitions d'objets Visual Basic
Méthode
CHostDataManager
DeleteObject
Launch(nom)
Lancer
Propriétés CHostData
Le tableau suivant décrit les propriétés et les paramètres disponibles pour l'objet
CHostData.
Dans Tableau 2-17, remplacez les informations entre les chevrons par lesvaleurs
réelles.
Tableau 2-17
CHostData - Propriétés et paramètres
valeur
renvoyés
= booléen
Paramètre =
Nom comme
chaîne
= booléen
DescriptionParamètre ou
VRAI si l'objet est supprimé.Valeur renvoyée
Lance un fichier d'objet hôte, ce qui ouvre la
fenêtre de terminal de l'hôtepcAnywhere. Le
paramètre est le fichier objet hôte
entièrement qualifié de l'objet à lancer.
VRAI si l'objet est lancé avec succès.Valeur renvoyée
DescriptionParamètrePropriété
Chaîne<CHostData>.PhoneNumber(chaîne)
Bool<CHostData>.UseDialingProperties(Bool)
Entier<CHostData>.RedialCount(entier)
Entier<CHostData>.RedialDelay(entier)
Chaîne<CHostData>.Password(chaîne)
Définit lenuméro detéléphone del'ordinateur
hôte.
Définit les propriétés de numérotation du
système.
Définit lenombre detentatives derappel avant
l'annulation de l'appel.
Définit le nombre de secondes d'attente entre
les tentatives de rappel.
Définit le mot de passe sur l'objet hôte, à
utiliser avec les méthodes ExecuteProtection,
ReadProtection et WriteProtection.
Pour des raisons de sécurité, le serveur
d'automatisation pcAnywhere ne permet pas
de lire la valeur du mot de passe. Aucune
valeur de mot de passe n'est renvoyée.
Page 38
Définitions d'objets Visual Basic
38
Propriétés CHostData
DescriptionParamètrePropriété
Bool<CHostData>.ExecuteProtection (Bool)
Bool<CHostData>.ReadProtection(Bool)
Bool<CHostData>.WriteProtection(Bool)
Chaîne<CHostData>.RecordFile(chaîne)
Bool<CHostData>.RecordSession(Bool)
Chaîne<CHostData>.ReadObject(chaîne)
Chaîne<CHostData>.WriteObject(chaîne)
Définit la nécessité d'un mot de passe pour
exécuter l'objet. Définir par mot de passe.
Définit l'obligation d'un mot de passe pour
afficher les propriétés de l'objet hôte. Définir
par mot de passe.
Définit l'obligation d'un mot de passe pour
enregistrer les modification de l'objet hôte.
Définir par mot de passe.
Active etdésactive laconsignation dessessionsBool<CHostData>.LogSession (Bool)
Définit le nom et le chemin d'accès
intégralement qualifié du fichier
d'enregistrement de la session active.
Active et désactive la consignation
automatique de session.
Définit le mot de passede l'objet. Vous pouvez
utiliser cette propriété pour actualiser la copie
locale des données de l'objet hôte.
Définit le mot de passe de l'objet. Utilisez cette
propriété pourcréer l'objethôte ou pour écrire
les changements apportés à celui-ci.
Propriété
Le tableau suivant décrit les propriétés et les valeurs renvoyées par CHostData.
Dans Tableau 2-18, remplacez les informations entre les chevrons par lesvaleurs
réelles.
Tableau 2-18
CHostData - Propriétés et valeurs renvoyées
DescriptionValeur
renvoyée
ChaîneString = <CHostData>.PhoneNumber
BoolBool = <CHostData>.UseDialingProperties
EntierInteger = <CHostData>.RedialCount
Renvoie lenuméro detéléphone del'ordinateur
hôte
Renvoie l'utilisation des propriétés de
numérotation dusystème définies dansl'objet
hôte.
Renvoie lenombre de tentativesd'appel défini
dans l'objet hôte.
Page 39
Propriétés CHostData
39Définitions d'objets Visual Basic
Propriété
renvoyée
EntierInteger = <CHostData>.RedialDelay
BoolBool = <CHostData>.ExecuteProtection
BoolBool = <CHostData>.ReadProtection
BoolBool = <CHostData>.WriteProtection
ChaîneString = <CHostData>.RecordFile
BoolBool = <CHostData>.RecordSession
Propriétés du type de connexion
Le tableau suivant décrit les propriétés et les paramètres du type de connexion.
Dans Tableau 2-19, remplacez les informations entre les chevrons par lesvaleurs
réelles.
DescriptionValeur
Renvoie lenombre desecondes d'attenteentre
les tentatives de rappel.
Renvoie la valeur du paramètre
ExecuteProtection.
Renvoie la valeur du paramètre
ReadProtection.
Renvoie la valeur du paramètre
WriteProtection.
VRAI si la consignation de session est activée.BoolBool = <CHostData>.LogSession
Renvoie le nom et le chemin d'accès
intégralement qualifié du fichier
d'enregistrement de la session.
Renvoie la valeur du paramètre
d'enregistrement de session.
Page 40
Définitions d'objets Visual Basic
40
Propriétés CHostData
Tableau 2-19
Type de connexion - Propriétés et paramètres
DescriptionParamètrePropriété
Chaîne<CHostData>.ConnectionType(chaîne)
Chaîne<CHostData>.AssignConnection(chaîne)
Chaîne<CHostData>.UnassignConnection(chaîne)
Définit letype deconnexion del'hôte. Lavaleur
transmise doit être un type de connexion
valide, défini par les fonctions
FirstConnectionType() et
NextConnectionType().
Les types suivants sont des exemples de
connexions valides :
■ COM1
■ COM2
■ COM3
■ COM4
■ TCP/IP
■ SPX
■ NetBIOS
■ RNIS via CAPI 2.0
■ Nom du modem (tel qu'il apparaît sur
l'ordinateur)
Définit le type de connexion présent dans la
chaîne sur l'état actif.
Définit le type de connexion présent dans la
chaîne sur l'état inactif.
Propriété
Le tableau suivant décrit les propriétés et les valeurs renvoyées pour le type de
connexion.
Dans Tableau 2-20, remplacez les informations entre les chevrons par lesvaleurs
réelles.
Tableau 2-20
Type de connexion - Propriétés et valeurs renvoyées
DescriptionValeur
renvoyée
Renvoie le type de connexion de l'objet hôte.ChaîneString = <CHostData>.ConnectionTypes
Page 41
Propriétés CHostData
41Définitions d'objets Visual Basic
Propriété
renvoyée
EntierInteger = <CHostData>.ConnectionType
ChaîneString = <CHostData>.FirstConnectionType
ChaîneString = <CHostData>.NextConnectionType
DescriptionValeur
Renvoie le nombre de types de connexion
disponibles.
Les types suivants sont des exemples de
connexions valides :
■ COM1
■ COM2
■ COM3
■ COM4
■ TCP/IP
■ SPX
■ NetBIOS
■ RNIS via CAPI 2.0
■ Nom du modem (tel qu'il apparaît sur
l'ordinateur)
Renvoie le premier type de connexion
disponible.
Renvoie le type de connexion disponible
suivant. L'appel s'effectue de façon
séquentielle pour le nombre de types de
connexion défini dans
<CHostData>.ConnectionType, afin
d'énumérer tous les types de connexion.
connexion)
de connexion)
BoolBool =<CHostData>.FindConnectionType(type de
VRAI si le type de connexion indiqué a été
trouvé dans la liste des types de connexion
disponibles.
EntierInteger =<CHostData>.MaxAssignedConnections
Renvoie le nombre maximum de types de
connexion quipeuvent êtreactifs surcet hôte.
Renvoie le premier type de connexion actif
affecté.
ChaîneString = <CHostData>.NextAssignedConnection
Renvoie le type de connexion actif affecté
suivant.
BoolBool =<CHostData>.FindAssignedConnection(type
VRAI si le type de connexion transmis
correspond à l'un des types de connexion
actifs.
Page 42
Définitions d'objets Visual Basic
42
Propriétés CHostData
Méthode AssignConnection(type de connexion)
Cette méthode place le type de connexion requis dans la liste des types de
connexion affectés à l'objet Hôte et en fait le type de connexion en cours lors du
traitement ultérieur des appels de méthodes spécifiques au périphérique.
Si letype de connexion requis se trouve déjàdans la liste des connexions affectées,
celle-ci ne change pas. Seul le type de connexion actuel est remplacé par le type
demandé. Ilest normal d'appeler la méthode AssignConnection surle même objet
plusieurs fois lors de l'obtention et de la définition de valeurs propres à la
connexion.
AssignConnection renvoie VRAI si le type de connexion transmis existe sur
l'ordinateur et est affecté avec succès ou déjà affecté. Il renvoie FAUX si le type
de connexion requis n'existe pas sur l'ordinateur ou si le nombre de connexions
affectées a déjà atteint le maximum.
Un objethôte pcAnywherepeut prendreen chargejusqu'à deuxtypes deconnexion
affectés. Laméthode AssignConnection renvoie FAUX si elle détecte une tentative
de dépassement de cette limite.
Le tableau suivant définit le paramètre AssignConnection :
DescriptionParamètre
Nom d'un type de périphérique de connexion à affecter.Type deconnexion
comme chaîne
Le tableau suivant définit la valeur renvoyée pour AssignConnection :
DescriptionValeur renvoyée
Booléenne
VRAI si ce type de périphérique est disponible et si le nombre
maximum de connexions affectées n'a pas encore été atteint.
Méthode UnassignConnection (type de connexion)
Cette méthode renvoie VRAI si le type de connexion transmis a pu être retiré de
la liste des types de connexion affectés.
Le tableau suivant définit le paramètre UnassignConnection :
DescriptionParamètre
Nom d'un type de périphérique de connexion à désaffecter.Type deconnexion
comme chaîne
Page 43
Le tableau suivant définit la valeur renvoyée pour UnassignConnection :
Propriétés de numérotation
Le tableau suivant décrit les propriétés et les valeurs renvoyées pour définir les
propriétés de numérotation pour les connexions par modem.
Dans Tableau 2-21, remplacez les informations entre les chevrons par lesvaleurs
réelles.
Propriétés CHostData
43Définitions d'objets Visual Basic
DescriptionValeur renvoyée
VRAI si ce type de périphérique est désaffecté avec succès.Booléenne
Propriété
Tableau 2-21
Propriétés de numérotation - Propriétés et paramètres
DescriptionParamètrePropriété
Chaîne<CHostData>.AreaCode(chaîne)
Chaîne<CHostData>.CountryCode(chaîne)
Définit le code de zone pour les connexions
par modem
Définit l'indicatif international pour les
connexions par modem
Le tableausuivant définit les propriétés et les valeursrenvoyées pourles propriétés
de numérotation par modem.
Dans Tableau 2-22, remplacez les informations entre les chevrons par lesvaleurs
réelles.
Tableau 2-22
Propriétés de numérotation par modem - Propriétés et valeurs
renvoyées
DescriptionValeur
renvoyée
Renvoie le code de zoneChaîneString = <CHostData>.AreaCode
Renvoie le premier indicatif de pays
apparaissant dans la liste du système
d'exploitation.
Page 44
Définitions d'objets Visual Basic
44
Propriétés CHostData
Propriété
renvoyée
ChaîneString = <CHostData>.NextCountryCode
Propriétés de périphérique COM
Le tableau suivant définit les propriétés et les paramètres qui vous permettent
de personnaliserles paramètres de port du modem etdes autresconnexions COM.
Dans Tableau 2-23, remplacez les informations entre les chevrons par lesvaleurs
réelles.
Tableau 2-23
Périphérique COM - Propriétés et paramètre
Chaîne<CHostData>.ComParity (chaîne)
DescriptionValeur
Renvoie l'indicatif international disponible
suivant. L'appel s'effectue de façon
séquentielle pour le nombre d'indicatifs
internationaux défini dans
<CHostData>.CountryCodes, afin d'énumérer
tous les indicatifs internationaux.
DescriptionParamètrePropriété
Définit la parité des communications.
Les valeurs suivantes sont valides :
■ <Aucune>
■ Impaire
■ Paire
■ Marque
■ Espace
Chaîne<CHostData>.ComFlowControl (chaîne)
Définit le contrôle de flux des types de
connexion COM.
Les valeurs suivantes sont valides :
■ <Aucune>
■ XONXOFF
■ RTS/CTS
■ Les deux
Page 45
Propriétés CHostData
45Définitions d'objets Visual Basic
DescriptionParamètrePropriété
Chaîne<CHostData>.ComStartedBy(chaîne)
Définit le paramètre de début des types de
connexion COM.
Les valeurs suivantes sont valides :
■ Toujours connecté
■ Détection de porteuse (DCD)
■ Prêt à émettre (CTS)
■ Ensemble de données prêt (DSR)
■ Signal de sonnerie (RI)
■ Réception 2 <RC>
■ Réponse du modem
Chaîne<CHostData>.ComEndedBy(chaîne)
Définit le paramètre de fin des types de
connexion COM.
Les valeurs suivantes sont valides :
■ Toujours connecté
■ Détection de porteuse (DCD)
■ Prêt à émettre (CTS)
■ Ensemble de données prêt (DSR)
■ Signal de sonnerie (RI)
Long<CHostData>.ComSpeed(Long)
Définit la vitesse COM maximale
Les valeurs suivantes sont valides :
■ 110
■ 300
■ 600
■ 1200
■ 2400
■ 4800
■ 9600
■ 38400
■ 57600
■ 115200
Le tableausuivant décrit les propriétés et les valeursrenvoyées parle périphérique
COM.
Dans Tableau 2-24, remplacez les informations entre les chevrons par lesvaleurs
réelles.
Page 46
Définitions d'objets Visual Basic
46
Propriétés CHostData
Propriété
Tableau 2-24
Périphériques COM - Propriétés et valeurs renvoyées
DescriptionValeur
renvoyée
ChaîneString = <CHostData>.ComParity
ChaîneString = <CHostData>.ComFlowControl
ChaîneString = <CHostData>.ComStartedBy
Renvoie l'une des valeurs suivantes comme
parité de communications :
■ <Aucune>
■ Impaire
■ Paire
■ Marque
■ Espace
Renvoie le paramètre de contrôle de flux de
l'objet hôte.
Les valeurs suivantes sont valides :
■ <Aucun>
■ XONXOFF
■ RTS/CTS
■ Les deux
Renvoie le contrôle de début des types de
connexion COM.
Les valeurs suivantes sont valides :
■ Toujours connecté
■ Détection de porteuse (DCD)
■ Prêt à émettre (CTS)
■ Ensemble de données prêt (DSR)
■ Signal de sonnerie (RI)
■ Réception 2 <RC>
■ Réponse du modem
ChaîneString = <CHostData>.ComEndedBy
Renvoie le contrôle de fin des types de
connexion COM
Les valeurs suivantes sont valides :
■ Toujours connecté
■ Détection de porteuse (DCD)
■ Prêt à émettre (CTS)
■ Ensemble de données prêt (DSR)
■ Signal de sonnerie (RI)
Page 47
Propriétés CHostData
47Définitions d'objets Visual Basic
Propriété
renvoyée
LongLong = <CHostData>.ComSpeed
Propriétés de périphérique NetBIOS
Le tableausuivant définit les propriétés et les paramètres d'un périphériqueréseau
NetBIOS.
Dans Tableau 2-25, remplacez les informations entre les chevrons par lesvaleurs
réelles.
DescriptionValeur
Renvoie le paramètre de vitesse de
communication de l'objet hôte.
Les valeurs suivantes sont valides :
■ 110
■ 300
■ 600
■ 1200
■ 2400
■ 4800
■ 9600
■ 38400
■ 57600
■ 115200
Propriété
Tableau 2-25
NetBIOS - Propriétés et paramètres
DescriptionParamètrePropriété
Entier<CHostData>.LanaNumber(entier)
Définit lenuméro d'adaptateurréseau (LANA)
à utiliser pour les connexions NetBIOS.
Le tableau suivant définit les propriétés et les valeurs renvoyées pour un
périphérique réseau NetBIOS.
Dans Tableau 2-26, remplacez les informations entre les chevrons par lesvaleurs
réelles.
Tableau 2-26
Valeurs NetBIOS renvoyées
DescriptionValeur
renvoyée
EntierInteger = <CHostData>.LanaNumber
Renvoie le paramètre en cours du numéro
LANA pour les connexions NetBIOS.
Page 48
Définitions d'objets Visual Basic
48
objet CHostDataEx
Propriétés de périphérique RNIS via CAPI 2.0
Le tableau suivant définit les propriétés et les paramètres pour les connexions
RNIS européennes.
Dans Tableau 2-27, remplacez les informations entre les chevrons par lesvaleurs
réelles.
Tableau 2-27
Le Tableau2-28 définit les propriétés et les valeursrenvoyées pourles connexions
RNIS européennes.
Tableau 2-28
Propriété
objet CHostDataEx
L'objet CHostDataEx contient la même fonctionnalité que l'objet CHostData avec
une fonctionnalité supplémentaire.
Le tableau suivant décrit les propriétés et les paramètres.
Dans Tableau 2-29, remplacez les informations entre les chevrons par lesvaleurs
réelles.
RNIS via CAPI 2.0 - Propriétés et paramètres
DescriptionParamètrePropriété
Bool<CHostData>.CapiChannelBonding(Bool)
Chaîne<CHostData>.CapiExtensions(chaîne)
Active ou désactive la liaison de canaux pour
les périphériques RNIS CAPI.
Définit toute extension CAPI supplémentaire
nécessaire pour les communications.
RNIS via CAPI 2.0 - Propriétés et valeurs renvoyées
DescriptionValeur
renvoyée
BoolBool= <CHostData>.CapiChannelBonding
ChaîneString = <CHostData>.CapiExtensions
Renvoie le paramètre de liaison de canaux
RNIS CAPI en cours dans l'objet hôte.
Renvoie la liste actuelle des extensions CAPI
à partir de l'objet hôte.
Tableau 2-29
CHostDataEx - Propriétés et paramètres
DescriptionParamètrePropriété
Chaîne<CHostData>.CryptPrivateKey (chaîne)
Définit le nom du conteneur de clé privée à
utiliser
Page 49
objet CHostDataEx
49Définitions d'objets Visual Basic
DescriptionParamètrePropriété
Chaîne<CHostData>.CryptCommonName (chaîne)
Définit le nom commun de la clé privée à
utiliser.
Octet<CHostData>.CryptReqLevel(Octet)
Définit le niveau de chiffrement.
Les valeurs suivantes sont valides :
■ -1: Aucun
■ 0: pcAnywhere
■ 1: Symétrique
■ 2: Clé publique
Bool<CHostData>.CryptRefuseLower(Bool)
Définit si l'ordinateur hôte accepte une
connexion d'unordinateur distantutilisant un
niveau de chiffrement inférieur.
Chaîne<CHostData>.CallersPath(chaîne)
Définit le chemin d'accès intégralement
qualifié des fichiers d'appelant.
Bool<CHostData>.ConfirmConnect(Bool)
Définit siun messagedemandera àl'utilisateur
hôte de confirmer les connexions.
Octet<CHostData>.ConfirmTimeout(Octet)
Définit le nombre de secondes de délai pour
confirmer la connexion.
Bool<CHostData>.ConfirmDeny(Bool)
Définit sila connexiondoit seterminer lorsque
le délaide confirmationde laconnexion expire.
Bool<CHostData>.PwCaseSensitive(Bool)
Impose l'utilisationde motsde passesensibles
à la casse.
Octet<CHostData>.PwAttempts(Octet)
Définit le nombre d'échecs d'ouverture de
session consécutifs autorisés avant l'abandon
de la connexion.
Octet<CHostData>.PwTimeout(Octet)
Définit le nombre de minutes dont dispose
l'utilisateur pour ouvrir une session avant
l'abandon de la connexion.
Octet<CHostData>.ActiveKbds(Octet)
Définit quelle souris et quel clavier seront
actifs pendant la connexion.
Les valeurs suivantes sont valides :
■ 0: Hôte et distant
■ 1: Hôte
■ 2: Distant
Page 50
Définitions d'objets Visual Basic
50
objet CHostDataEx
DescriptionParamètrePropriété
Octet<CHostData>.InactiveTimeout(Octet)
Définit le nombre de minutes pendant lequel
le clavier et la souris peuvent rester inactifs
avant l'abandon de la connexion.
Bool<CHostData>.LockSystemWhileWait(Bool)
Définit leverrouillage del'ordinateur hôte lors
du démarrage.
Bool<CHostData>.MinimizeOnLaunch(Bool)
Définit l'option de démarrage de l'hôte en
réduction.
Bool<CHostData>.RunAsService(Bool)
Active le fonctionnement de l'hôte comme
service.
Octet<CHostData>.ConnLostWait(Octet)
Définit le nombre de minutes d'attente avant
d'autoriser un autre appelant à se connecter.
Bool<CHostData>.ConnLostHostOpts(Bool)
Définit s'il faut attendre une autre connexion
ou annuler l'hôte si la session se termine de
façon anormale.
Les valeurs suivantes sont valides :
■ FAUX : Attente de la connexion suivante
■ VRAI : Annulation de l'hôte
Bool<CHostData>.EnableConnLostSecurity(Bool)
Active ou désactive les options de sécurité de
fin de session pour les sessions qui se
terminent de façon anormale.
Page 51
objet CHostDataEx
51Définitions d'objets Visual Basic
DescriptionParamètrePropriété
Octet<CHostData>.AuthenticationType(octet)
Définit le type d'authentification.
Les valeurs suivantes sont valides :
■ 0: pcAnywhere
■ 1: pcAnywhere
■ 2: Windows
■ 3: NT
■ 4: pcAnywhere
■ 5: pcAnywhere
■ 6: ADS Active Directory Services
■ 7: Microsoft LDAP
■ 8: FTP
■ 9: HTTP
■ 10: HTTPS
■ 11: RSA SecurID
L'authentification pcAnywhereest utiliséepar
défaut siaucune valeurd'authentification n'est
définie ou si la valeur définie n'est pas valide
(par exemple,si letype d'authentificationn'est
pas disponible).
Octet<CHostData>.ConnLostSecurity(octet)
Définit lesoptions desécurité pour traiter une
fin de session anormale.
Les valeurs suivantes sont valides :
■ 1: Déconnecter l'utilisateur
■ 2: Redémarrer l'ordinateur hote
■ 3: Verrouiller l'ordinateur
Octet<CHostData>.CallbkDelay(octet)
Définit le nombre de secondes d'attente avant
que le modem hôte ne rappelle l'ordinateur
distant.
Bool<CHostData>.EndSessHostOpts(Bool)
Définit sil'hôte attendune autreconnexion ou
est annulé après la fin normale de la session.
Les valeurs suivantes sont valides :
■ FAUX : Attente de la connexion suivante
■ VRAI : Annulation de l'hôte
Bool<CHostData>.EnableEndSessSecurity(Bool)
Active oudésactive lesoptions desécurité pour
une fin de session normale.
Page 52
Définitions d'objets Visual Basic
52
objet CHostDataEx
DescriptionParamètrePropriété
Octet<CHostData>.EndSessSecurity(octet)
Bool<CHostData>.BlankHost(Bool)
Bool<CHostData>.AllowRemoteMouse(Bool)
Bool<CHostData>.RebootOnDisconnect(Bool)
Bool<CHostData>.PasswordAfterDisc(Bool)
Bool<CHostData>.LogFailures(Bool)
Bool<CHostData>.AllowDriveSecurity(Bool)
Définit les options de sécurité pour une fin de
session normale.
Les valeurs suivantes sont valides :
■ 1: Déconnecter l'utilisateur
■ 2: Redémarrer l'ordinateur hote
■ 3: Verrouiller l'ordinateur
Définit l'effacement de l'écran de l'ordinateur
hôte. Certainescartes d'affichage neprennent
pas en charge cette fonction.
Désactive l'utilisation de la souris sur
l'ordinateur distant pendant une session.
Si VRAI,force l'ordinateur àredémarrer après
toute fin de session.
Déconnecte l'utilisateur lorsque la session se
termine.
Consigne les tentatives de mot de passe qui
ont échoué.
Active les options de sécurité de lecteur. Ce
paramètre n'estvalide quesur lessystèmes de
fichiers NTFS.
Propriété
Bool<CHostData>.UseDirectoryServices(Bool)
Active l'utilisationdes servicesd'annuaire pour
l'authentification.
Le tableau suivant décrit les propriétés et les valeurs renvoyées pour l'objet
CHostDataEx.
Dans Tableau 2-30, remplacez les informations entre les chevrons par lesvaleurs
réelles.
Tableau 2-30
CHostDataEx - Propriétés et valeurs renvoyées
DescriptionValeur
renvoyée
ChaîneString = <CHostDataEx>.CryptPrivateKey
Renvoie le nom du conteneur de clé privée
actuellement actif.
Page 53
objet CHostDataEx
53Définitions d'objets Visual Basic
Propriété
renvoyée
ChaîneString = <CHostDataEx>.CryptCommonName
OctetByte = <CHostDataEx>.CryptReqLevel
BoolBool = <CHostDataEx>.CryptRefuseLower
ChaîneString = <CHostDataEx>.CallersPath
BoolBool = <CHostDataEx>.ConfirmConnect
OctetByte = <CHostDataEx>.ConfirmTimeout
BoolBool = <CHostDataEx>.ConfirmDeny
DescriptionValeur
Renvoie le nom commun du conteneur de clé
privée actif.
Renvoie l'un des paramètres de chiffrement
suivants :
■ -1: Aucun
■ 0: pcAnywhere
■ 1: Symétrique
■ 2: Clé publique
Renvoie la valeur du paramètre de rejet de
niveau de chiffrement inférieur.
Renvoie le chemin d'accès intégralement
qualifié des fichiers d'appelant.
Renvoie la valeur du paramètre de
confirmation de connexion.
Renvoie la valeur du paramètre de rejet de
niveau de chiffrement inférieur.
Renvoie la valeur du paramètre de
déconnexion sur délai dépassé.
BoolBool = <CHostDataEx>.PwCaseSensitive
Renvoie la valeur du paramètre de mot de
passe sensible à la casse.
OctetByte = <CHostDataEx>.PwAttempts
Renvoie la valeur du paramètre de nombre
limite detentatives d'ouverture de session par
appel.
OctetByte = <CHostDataEx>.PwTimeout
Renvoie la valeur du paramètrede délai limite
d'ouverture de session (en minutes).
OctetByte = <CHostDataEx>.ActiveKbds
Renvoie les paramètres de clavier et de souris
actifs.
Les valeurs suivantes sont valides :
■ 0: Hôte et distant
■ 1: Hôte
■ 2: Distant
Page 54
Définitions d'objets Visual Basic
54
objet CHostDataEx
Propriété
renvoyée
OctetByte = <CHostDataEx>. InactiveTimeout
BoolBool = <CHostDataEx>.LockSystemWhileWait
BoolBool = <CHostDataEx>.MinimizeOnLaunch
BoolBool = <CHostDataEx>.RunAsService
OctetByte = <CHostDataEx>.ConnLostWait
BoolBool = <CHostDataEx>.ConnLostHostOpts
BoolBool = <CHostDataEx>.ConnLostWait
DescriptionValeur
Renvoie le nombre de minutesd'attente avant
déconnexion si la limite d'inactivité est
atteinte.
Renvoie le paramètre de verrouillage de
l'ordinateur hôte au démarrage.
Renvoie le paramètre de démarrage de l'hôte
en réduction.
Renvoie le paramètre de fonctionnement de
l'hôte comme service.
Renvoie le nombre de minutesd'attente avant
d'autoriser un autre appelant à se connecter.
Renvoie le paramètre déterminant si l'hôte
attend une autre connexion ou s'arrête si la
session se termine de façon anormale.
Les valeurs suivantes sont valides :
■ FAUX : Attente de la connexion suivante
■ VRAI : Annulation de l'hôte
Renvoie lavaleur del'option desécurité définie
pour traiter une fin de session anormale.
Page 55
objet CHostDataEx
55Définitions d'objets Visual Basic
Propriété
renvoyée
OctetByte = <CHostDataEx>.AuthenticationType
OctetByte = <CHostDataEx>.ConnLostSecurity
DescriptionValeur
Renvoie la référence de nombre du type
d'authentification.
Les valeurs suivantes sont valides :
■ 0: pcAnywhere
■ 1: pcAnywhere
■ 2: Windows
■ 3: NT
■ 4: pcAnywhere
■ 5: pcAnywhere
■ 6: ADS Active Directory Services
■ 7: Microsoft LDAP
■ 8: FTP
■ 9: HTTP
■ 10: HTTPS
■ 11: RSA SecurID
L'authentification pcAnywhereest utiliséepar
défaut siaucune valeurd'authentification n'est
définie ou si la valeur définie n'est pas valide
(par exemple,si letype d'authentificationn'est
pas disponible).
Renvoie la représentation numérique du
niveau de sécurité défini pour traiter une fin
de session anormale.
Les valeurs suivantes sont valides :
■ 1: Déconnecter l'utilisateur
■ 2: Redémarrer l'ordinateur hote
■ 3: Verrouiller l'ordinateur
OctetByte = <CHostDataEx>.CallbkDelay
Renvoie lenombre desecondes d'attenteavant
que le modem hôte ne rappelle l'ordinateur
distant.
BoolBool = <CHostDataEx>.EndSessHostOpts
Renvoie le paramètre déterminant si l'hôte
attend uneautre connexionou estannulé après
une fin de session normale.
Les valeurs suivantes sont valides :
■ FAUX : Attente de la connexion suivante
■ VRAI : Annulation de l'hôte
Page 56
Définitions d'objets Visual Basic
56
objet CHostDataEx
Propriété
renvoyée
BoolBool = <CHostDataEx>.EnableEndSessSecurity
OctetByte = <CHostDataEx>.EndSessSecurity
BoolBool = <CHostDataEx>.BlankHost
BoolBool = <CHostDataEx>.AllowRemoteMouse
BoolBool = <CHostDataEx>.RebootOnDisconnect
BoolBool = <CHostDataEx>.PasswordAfterDisc
BoolBool = <CHostDataEx>.LogFailures
DescriptionValeur
Renvoie le paramètre déterminant si les
options de sécurité de fin de session sont
activées pour une fin de session normale.
Renvoie l'option de sécurité définie pour une
fin de session normale.
Les valeurs suivantes sont valides :
■ 1: Déconnecter l'utilisateur
■ 2: Redémarrer l'ordinateur hote
■ 3: Verrouiller l'ordinateur
Renvoie l'option définie pour l'effacement de
l'écran.
Renvoie l'option déterminant si l'utilisateur
distant dispose du contrôle du clavier et de la
souris au cours d'une session.
Renvoie l'option déterminant si l'ordinateur
hôte redémarre après la fin de la session.
Renvoie l'option déterminant si l'hôte est
déconnecté après la fin de la session.
Renvoie l'option déterminant si les échecs de
mots de passe sont consignés.
BoolBool = <CHostDataEx>.AllowDriveSecurity
BoolBool = <CHostDataEx>.UseDirectoryServices
Renvoie l'option déterminant si la sécurité du
lecteur est activée.
Renvoie l'option déterminant si les services
d'annuaire sont activés.
Les fonctionsAwrem32 fournissentdes paramètres et renvoient des valeurs pour
la gestion des connexions entre l'ordinateur hôte et l'ordinateur distant.
fonction awrem32
awConnect(nom de fichier)
awConnect
awDisconnect()
FileXferFromHost(HostFile)
FileXferFromHost(RemoteFile)
FileXferFromHost
valeur
renvoyés
Paramètre =
Nom comme
chaîne
= booléen
Valeur renvoyée
= booléen
Paramètre =
HostFile comme
chaîne
Paramètre =
RemoteFile
comme chaîne
= booléen
DescriptionParamètre ou
Nom intégralementqualifié dufichier .chf
contenant les informations sur
l'ordinateur hôte.
VRAI si la commande est exécutée.Valeur renvoyée
Après avoir appelé cette fonction, le
programme appelant doit supprimer
l'objet (C++ -delete IAwrem32X*, VB – set
ObjectName = Nothing;)
Contient le chemind'accès intégralement
qualifié du fichier à copier à partir de
l'ordinateur hôte.
Contient lechemin d'accèsde destination,
intégralement qualifié. Les chaînes de
fichier hôte et de fichier distant ne sont
pas obligatoirement identiques.
VRAI si la commande est exécutée.Valeur renvoyée
Page 59
fonctions awrem32
59Définitions d'objets Visual Basic
fonction awrem32
FileXferToHost(HostFile)
FileXferToHost(RemoteFile)
CreateFolderOnHost(nom
de répertoire)
CreateFolderOnHost
ExecuteHostFile(nom de
fichier)
valeur
renvoyés
Paramètre =
HostFile comme
chaîne
Paramètre =
RemoteFile
comme chaîne
Paramètre =
FolderName
comme chaîne
= booléen
Paramètre =
Nom de fichier
comme chaîne
DescriptionParamètre ou
Copie un fichier de l'ordinateur distant
vers l'ordinateur hôte. Les paramètres
peuvent contenir des caractères
génériques.
Le paramètre contient le chemin d'accès
de destination et le nom de fichier,
entièrement qualifiés.
Contient le chemind'accès intégralement
qualifié du fichier à copier à partir de
l'ordinateur distant.Les chaînesde fichier
hôte et de fichier distant ne sont pas
obligatoirement identiques.
Contient lelecteur etle chemind'accès du
dossier sur l'ordinateur hôte.
VRAI si la commande est exécutée.Valeur renvoyée
Exécute un fichier existant sur
l'ordinateur hôte. Cette fonction ne peut
exécuter que les fichiers batch, de
commandes etexécutables. Ellen'exécute
pas les fichiers associés aux exécutables.
Par exemple, cette fonction n'ouvre pas
Microsoft Wordsi vousexécutez unfichier
.doc.
Le paramètre contient le chemin d'accès
intégralement qualifié du fichier sur
l'ordinateur hôte.
ExecuteHostFile
GetError()
= booléen
Valeur renvoyée
= Chaîne
VRAI si la commande est exécutée.Valeur renvoyée
Renvoie la dernière erreur générée dans
Awrem32.
Page 60
Définitions d'objets Visual Basic
60
fonctions awrem32
fonction awrem32
ConnectionStatus()
valeur
renvoyés
Valeur retournée
= Court
DescriptionParamètre ou
Renvoie l'état courant de la connexion à
l'ordinateur hôte.
Les valeurs possibles sont les suivantes :
■ -1 = Connexion perdue
■ 0 = Aucune connexion
■ 1 = Session connectée
Page 61
Chapitre
Définitions d'objets Visual
C++
Ce chapitre traite des sujets suivants :
■ A propos des objets Visual C++
■ Méthodes CRemoteDataManager
■ objet CRemoteData
■ objet CRemoteDataEx
3
■ Méthodes CHostDataManager
■ objet CHostData
■ objet CHostDataEx
■ fonctions awrem32
A propos des objets Visual C++
Le serveur d'automatisation pcAnywhere offre les composants suivants pour la
prise en charge de l'automatisation OLE :
Winawsvr
Awrem32
Les objets décrits dans le Tableau 3-1 composent Winawsvr.
Contient lesinformations nécessairespour seconnecter au serveur
d'automatisation pcAnywhere et accéder à ses interfaces.
Fournit les méthodes pour créer, ouvrir,
modifier, enregistrer et supprimer les
objets CRemoteData.
Définit les paramètres permettant
d'accéder à la fonction distant de
pcAnywhere et de la contrôler.
Fournit les méthodes pour créer, ouvrir,
modifier, enregistrer et supprimer les
objets ChostData.
Définit les paramètres permettant
d'accéder àla fonctionhôte depcAnywhere
et de la contrôler.
Se reporter à "Méthodes
CRemoteDataManager" à la page 62.
Se reporter à "objet CRemoteData"
à la page 66.
Se reporter à "objet CRemoteDataEx"
à la page 72.
Se reporter à "Méthodes
CHostDataManager" à la page 73.
Se reporter à "objet CRemoteData"
à la page 66.
Se reporter à "objet CRemoteDataEx"
à la page 72.
Awrem32 possède un objet, constitué de huit interfaces, pour prendre en charge
les sessions de téléintervention et de transfert de fichiers.
Se reporter à "fonctions awrem32" à la page 88.
Quelques fonctions ne sont plus prises en charge. Cependant, les définitions
d'objets sont utilisables avec les versions précédentes.
Pour les fonctions nécessitant des mots de passe, les valeurs des mots de passe
peuvent être définies mais non récupérées, pour des raisons de sécurité.
Méthodes CRemoteDataManager
Les méthodes CRemoteDataManager fournissent les paramètres et renvoient les
valeurs permettant d'accéder aux objets CRemoteData et de les contrôler.
Méthode
valeur renvoyés
BSTR CurrentDirectory();
Paramètre =
BSTR
DescriptionParamètre ou
Nom complet de chemin d'accès au
dossier dedonnées pcAnywhereen cours
dans lequel les objets distants sont
enregistrés.
Page 63
Méthodes CRemoteDataManager
63Définitions d'objets Visual C++
Méthode
BOOL
ChangeDirectory(LPCTSTR
lpszNewDirectory);
BOOL FindFirst(LPCTSTR
lpszPattern, BSTR FAR* );
BOOL
FindFirst(pbstrFullQualName);
BOOL FindFirst
BOOL FindNext(BSTR FAR*
pbstrFullQualName);
valeur renvoyés
Paramètre =
LPCTSTR
lpszNewDirectory
Valeur renvoyée
= booléen
Paramètre =
LPCTSTR
lpszPattern
Parameter =
BSTR FAR *
pbstrFullQualName
Valeur renvoyée
= booléen
Parameter =
BSTR FAR *
pbstrFullQualName
Valeur renvoyée
= booléen
DescriptionParamètre ou
Change le dossier actuel dans lequel les
objets distantspcAnywhere sontstockés.
Le paramètre est le nom d'un dossier
existant.
La valeur retournée est VRAIE en cas de
succès.
Schéma de nom de fichier pour filtrer
les fichiers d'objet (un astérisque [*]
trouve tousles fichiersdans lerépertoire
en cours).
Tampon deretour pourle chemin d'accès
complet du fichier d'objet distant
correspondant au schéma spécifié.
VRAI si un fichier d'objet distant
correspondant au schéma spécifié est
trouvé. Le chemin d'accès complet du
fichier est stocké dans
pbstrFullQualName.
Après l'appel réussi de FindFirst() pour
obtenir le nom d'un fichier d'objet
distant dans le dossier en cours,
FindNext() peutêtre appelépour trouver
le fichier suivant correspondant au
schéma.
Renvoie la valeur VRAI si un autre
fichier d'objet distant correspondant au
schéma spécifié dans l'appel de
FindFirst() esttrouvé. Lechemin d'accès
complet du fichier est stocké dans
pbstrFullQualName.
LPDISPATCH
RetrieveObject(LPCTSTR
lpszFQName);
Parameter =
LPCTSTR
lpszFQName
Récupère unobjet CRemoteData parnom
de fichier.
Le paramètre est le nom intégralement
qualifié du fichier d'objet distant à
charger.
Page 64
Définitions d'objets Visual C++
64
Méthodes CRemoteDataManager
Méthode
LPDISPATCH
RetrieveObject(short
wAccessMode);
LPDISPATCH
RetrieveObject(LPCTSTR
lpszPassword);
LPDISPATCH
RetrieveObjectEx(LPCTSTR
lpszFQName);
LPDISPATCH
RetrieveObjectEx(short
wAccessMode);
valeur renvoyés
Parameter =
short
wAccessMode
LPCTSTR
lpszPassword
Parameter =
LPCTSTR
lpszFQName
Parameter =
short
wAccessMode
DescriptionParamètre ou
Spécifie comment cet objet doit être
utilisé. Ce paramètre est lié à la
protection parmot de passe.Les options
sont les suivantes :
■ 0 = Non spécifié
■ 1 = Afficher uniquement
■ 2 = Afficher et modifier
■ 3 = Exécuter
Mot de passe de l'objet. Peut être NULL.Parameter =
Récupère un objet CRemoteDataEx par
nom de fichier.
Le paramètre est le nom intégralement
qualifié du fichier d'objet distant à
charger.
Spécifie comment cet objet doit être
utilisé. Ce paramètre est lié à la
protection parmot de passe.Les options
sont les suivantes :
Mot de passe de l'objet. Peut être NULL.Parameter =
Pointeur sur un objet envoi OLE. L'objet
est un objet CRemoteDataEx.
Voir Exemple de code Visual C++ pour
la fonctionnalité du distant.
Page 65
Méthodes CRemoteDataManager
65Définitions d'objets Visual C++
Méthode
LPDISPATCH
CreateObject(LPCTSTR
lpszFQName);
LPDISPATCH
CreateObjectEx(LPCTSTR
lpszFQName);
valeur renvoyés
Parameter =
LPCTSTR
lpszFQName
Valeur renvoyée
= LPDISPATCH
Parameter =
LPCTSTR
lpszFQName
Valeur renvoyée
= LPDISPATCH
DescriptionParamètre ou
Crée un objet CRemoteData et renvoie
un pointeurLPDISPATCH quile désigne.
Le paramètre est le nom de fichier
entièrement qualifiéd'objet distantpour
le nouvel objet.
La valeur renvoyée est un pointeur vers
un objet envoi OLE. L'objet est un objet
CRemoteData.
Voir Exemple de code Visual C++ pour
la fonctionnalité du distant.
Crée unobjet CRemoteDataExet renvoie
un pointeurLPDISPATCH quile désigne.
Le paramètre est le nom de fichier
entièrement qualifiéd'objet distantpour
le nouvel objet.
La valeur renvoyée est un pointeur vers
un objet envoi OLE. L'objet est un objet
CRemoteDataEx.
Voir Exemple de code Visual C++ pour
la fonctionnalité du distant.
BOOL DeleteObject(LPCTSTR
lpszFQName);
BOOL DeleteObject(LPCTSTR
lpszPassword);
BOOL Launch(LPCTSTR
lpszFQName);
Parameter =
LPCTSTR
lpszFQName
LPCTSTR
lpszPassword
Parameter =
LPCTSTR
lpszFQName
Valeur renvoyée
= booléen
Supprime un fichier d'objet distant.
Le paramètre est le nom intégralement
qualifié du fichier d'objet distant de
l'objet à supprimer.
Mot de passe de l'objet. Peut être NULL.Parameter =
VRAI si l'objet est supprimé.BOOLBOOL DeleteObject
Lance un fichier d'objet distant, ce qui
ouvre la fenêtre de terminal distant
pcAnywhere.
Le paramètreest lefichier intégralement
qualifié d'objetdistant de l'objet à lancer.
La valeurrenvoyée estVRAI si l'objet est
lancé avec succès.
Page 66
Définitions d'objets Visual C++
66
objet CRemoteData
objet CRemoteData
Utilisez cet objet pour modifier les données d'objet distant.
Méthodes Get et Set (obtenir et définir)
Les méthodes suivantes servent à obtenir (Get) et définir (Set) les propriétés de
l'objet CRemoteData.
Le nom de l'ordinateur est le nom de système de l'hôte pcAnywhere à appeler
lorsque l'objet distant est lancé.
BSTR GetComputerName();
void SetComputerName(LPCTSTR lpszNewValue);
Le numérode téléphone est le numéro à composer pour établirune connexionpar
modem avec un ordinateur hôte pcAnywhere.
BSTR GetPhoneNumber();
void SetPhoneNumber(LPCTSTR lpszNewValue);
Indique sides propriétésde numérotation TAPI doivent être utilisées (informations
d'emplacement) (VRAI) ou si la chaîne du numéro de téléphone doit être utilisée
exactement telle qu'elle apparaît (FAUX).
BOOL GetUseDialingProperties();
void SetUseDialingProperties(BOOL bNewValue);
Si lespropriétés de numérotation sont utilisées, il s'agitdu codede zone du numéro
à appeler.
BSTR GetAreaCode();
void SetAreaCode(LPCTSTR lpszNewValue);
Si les propriétés de numérotation sont utilisées,il s'agit de l'indicatif international
du numéro à appeler.
BSTR GetCountryCode();
void SetCountryCode(LPCTSTR lpszNewValue);
Nombre de tentatives d'appel de ce numéro si l'appel échoue.
short GetRedialCount();
void SetRedialCount(short nNewValue);
Délai en secondes entre les tentatives d'appel.
Page 67
objet CRemoteData
short GetRedialDelay();
void SetRedialDelay(short nNewValue);
Nom d'utilisateurà envoyerà l'hôte lorsqu'une connexion est établie. Si ce champ
reste vide, l'utilisateur doit fournir un nom à la connexion.
BSTR GetAutoLoginName();
void SetAutoLoginName(LPCTSTR lpszNewValue);
Mot de passe de session envoyé à l'hôte lorsqu'une connexion est établie. Si ce
champ reste vide, l'utilisateur doit fournir un mot de passe lors de la connexion.
BSTR GetAutoLoginPassword();
void SetAutoLoginPassword(LPCTSTR lpszNewValue);
Mot de passe de cet objet.
BSTR GetPassword();
void SetPassword(LPCTSTR lpszNewValue);
L'objet ne peut être lancé que si le mot de passe est utilisé (VRAI).
BOOL GetExecuteProtection();
void SetExecuteProtection(BOOL bNewValue);
67Définitions d'objets Visual C++
L'objet ne peut être affiché que si le mot de passe correct est fourni (VRAI).
BOOL GetReadProtection();
void SetReadProtection(BOOL bNewValue);
L'objet ne peut être écrit que si le mot de passe correct est fourni (VRAI).
BOOL GetWriteProtection();
void SetWriteProtection(BOOL bNewValue);
Contrôle si les sessions utilisant cet objet sont consignées.
BOOL GetLogSession();
void SetLogSession(BOOL bNewValue);
Contrôle si les sessions utilisant cet objet sont enregistrées depuis le début.
BOOL GetRecordSession();
void SetRecordSession(BOOL bNewValue);
Nom du fichier d'enregistrement pour les sessions utilisant cet objet.
BSTR GetRecordFile();
void SetRecordFile(LPCTSTR lpszNewValue);
Page 68
Définitions d'objets Visual C++
68
objet CRemoteData
Définit les types de connexion.
BOOL GetRunOnConnect();
void SetRunOnConnect(BOOL bNewValue);
Les types de connexion suivants sont disponibles :
■ COM1
■ COM2
■ COM3
■ COM4
■ RNIS via CAPI 2.0
■ NetBIOS
■ SPX
■ DEFAULT TAPI
■ TCP/IP
Le nom d'un périphérique TAPI peut également servir de type de connexion.
DEFAULT TAPIutilise le premier périphérique TAPItrouvé dansle système. Pour
utiliser un périphérique TAPI spécifique, utilisez FirstConnectionType() /
NextConnectionType() pour rechercher les périphériques disponibles.
Méthodes de détail d'objet distant
Lorsqu'un type de connexion est affecté à un objet distant, les détails du
périphérique sont définis sur les valeurs par défaut valides.
Les typesde connexionsuivants possèdent des options de configuration avancées
qui peuvent être définies dans l'application :
■ Périphériques COM
■ Périphériques NetBIOS
■ Périphériques RNIS via CAPI 2.0 (RNIS européen seulement)
Détails de périphérique COM
Définit la parité des communications.
BSTR GetComParity();
void SetComParity(LPCTSTR lpszNewValue);
Les valeurs de parité de communication sont les suivantes :
Page 69
■ Aucune
■ Impaire
■ Paire
■ Marque
■ Espace
Définit le niveau de contrôle de flux.
BSTR GetComFlowControl();
void SetComFlowControl(LPCTSTR lpszNewValue);
Les valeurs de contrôle de flux sont les suivantes :
■ <Aucun>
■ XONXOFF
■ RTS/CTS
■ LES DEUX
Définit le paramètre de début de connexion.
objet CRemoteData
69Définitions d'objets Visual C++
BSTR GetComStartedBy();
void SetComStartedBy(LPCTSTR lpszNewValue);
Les valeurs de début de connexion sont les suivantes :
■ Toujours connecté
■ Détection de porteuse (DCD)
■ Prêt à émettre (CTS)
■ Ensemble de données prêt (DSR)
■ Signal de sonnerie (RI)
■ Réception 2 <CR>
■ Réponse du modem
Définit les valeurs de fin de connexion.
BSTR GetComEndedBy();
void SetComEndedBy(LPCTSTR lpszNewValue);
Les valeurs de fin de connexion sont les suivantes :
■ Toujours connecté
■ Détection de porteuse (DCD)
Page 70
Définitions d'objets Visual C++
70
objet CRemoteData
■ Prêt à émettre (CTS)
■ Ensemble de données prêt (DSR)
■ Signal de sonnerie (RI)
Définit la vitesse de connexion.
long GetComSpeed();
void SetComSpeed(long nNewValue);
Les valeurs de vitesse de connexion sont les suivantes :
■ 110
■ 300
■ 600
■ 1200
■ 2400
■ 4800
■ 9600
■ 19200
■ 38400
■ 57600
■ 115200
Détails de périphérique NetBios
Définit le numéro de LANA (adaptateur réseau) à utiliser pour cette connexion.
short GetLanaNumber();
void SetLanaNumber(short nNewValue);
Détails de périphérique RNIS via CAPI2.0
Active laliaison de canaux (utilise deux canaux RNIS pour uneconnexion) siVRAI.
BOOL GetCapiChannelBonding();
void SetCapiChannelBonding(BOOL bNewValue);
Définit touteextension CAPIsupplémentaire nécessairepour les communications.
BSTR GetCapiExtensions();
void SetCapiExtensions(LPCTSTR lpszNewValue);
Page 71
Méthodes d'objet distant
Les tableaux suivants décrivent les méthodes normales de l'objet distant (elles ne
servent pas à obtenir et à définir les propriétés de l'objet).
objet CRemoteData
71Définitions d'objets Visual C++
Méthode
short ConnectionTypes();
BSTR
FirstConnectionType(); et
BSTR
NextConnectionType();
Nombre de types de connexion
disponibles sur cet ordinateur
FirstConnectionType() et
NextConnectionType() servent à itérer
parmi les types de connexion
disponibles. Ces fonctions renvoient un
BSTR qui est le nom d'un type de
connexion disponible. Les types de
connexion renvoyéspeuvent êtreutilisés
avec la fonction SetConnectionType().
La valeur renvoyée est le nom d'un type
de périphérique de connexion pris en
charge.
Nom d'un type de périphérique de
connexion.
La valeurrenvoyée estVRAI si le type de
connexion transmis existe sur
l'ordinateur.
Renvoie le nombre d'indicatifs
internationaux disponibles.
FirstCountryCode() etNextCountryCode()
servent à circuler parmi les indicatifs
internationaux disponibles. Ces
fonctions renvoient un BSTR qui est le
nom d'un indicatif international
disponible. Les valeurs renvoyées
peuvent être utilisées avec la fonction
SetCountryCode().
La valeur renvoyée est la première
chaîne d'indicatifinternational ouchaîne
suivante.
Page 72
Définitions d'objets Visual C++
72
objet CRemoteDataEx
Méthode
BOOL ReadObject(LPCTSTR
lpszPassword);
BOOL WriteObject(LPCTSTR
lpszPassword);
objet CRemoteDataEx
L'objet CRemoteDataEx contient la même fonction quel'objet CRemoteData, avec
les méthodes supplémentaires Get et Set (obtenir et définir) suivantes :
BSTR GetPrivateKey(); //Renvoie les informations de PrivateKey
void SetPrivateKey(LPCTSTR lpszNewValue);
BSTR GetCertificationName(); //Renvoie le nom de certificat
void SetCertificationName(LPCTSTR lpszNewValue);
short GetEncryptionLevel(); //Renvoie la valeur du niveau de chiffrement
void SetEncryptionLevel(short nNewValue);
BOOL GetDenyLowerEncrypt(); //Renvoie la valeur DenyLowerEncrypt
void SetDenyLowerEncrypt(BOOL bNewValue);
BSTR GetAutoDomain(); //Renvoie la valeur AutoDomain
void SetAutoDomain(LPCTSTR lpszNewValue);
valeur renvoyés
Paramètre =
LPCTSTR
lpszPassword
Valeur renvoyée =
booléen
Paramètre =
LPCTSTR
lpszPassword
Valeur renvoyée =
booléen
DescriptionParamètre ou
Lit les données d'objet du fichier d'objet
distant.
Le paramètre est le mot de passe objet
La valeurrenvoyée est VRAI si l'objet est
lancé avec succès.
Ecrit les données d'objet dans le fichier
d'objet distant.
Le paramètre est le mot de passe objet
La valeurrenvoyée est VRAI si l'objet est
lancé avec succès.
Exemple de code Visual C++ pour la fonctionnalité du distant
L'exemple suivant de fonction C++ crée un objet distant, définit son type de
connexion surTCP/IP, définitle nomde l'ordinateur sur l'adresse TCP/IP transmise
dans la fonction, puis lance l'objet distant.
Le tablesuivant décritles méthodes CHostDataManager, y compris les paramètres
et les valeurs renvoyées pour accéder aux objets CHostData et les contrôler :
Page 74
Définitions d'objets Visual C++
74
Méthodes CHostDataManager
Méthode
BSTR CurrentDirectory();
BOOL
ChangeDirectory(LPCTSTR
lpszNewDirectory);
BOOL FindFirst(LPCTSTR
lpszPattern);
valeur renvoyés
Valeur renvoyée =
BSTR
Paramètre =
LPCTSTR
lpszNewDirectory
Valeur renvoyée =
booléen
Paramètre =
LPCTSTR
lpszPattern
Valeur renvoyée =
booléen
DescriptionParamètre ou
Renvoie le chemin d'accès complet du
répertoire en cours dans lequel les
objets hôtede pcAnywheresont stockés.
Change le dossier en cours dans lequel
les objets hôte de pcAnywhere sont
stockés.
Le paramètre est le nom d'un dossier
existant.
La valeur renvoyée est VRAI en cas de
succès.
Trouve le premier fichier d'objet hôte
pcAnywhere (*.bhf) dans le dossier en
cours, sur la base du schéma du nom de
fichier spécifié.
Le paramètre est le schéma de nom de
fichier pour filtrer les fichiers d'objet
(un astérisque[*] trouvetous lesfichiers
hôte dans le répertoire en cours).
La valeur renvoyée est VRAI si un
fichier d'objet hôte correspondant au
schéma spécifié est trouvé. Le chemin
d'accès complet du fichier est stocké
dans pbstrFullQualName.
BOOL FindFirst(BSTR
FAR* pbstrFullQualName);
Parameter = BSTR
FAR *
pbstrFullQualName
Tampon de retour pour le chemin
d'accès complet du fichier d'objet
distant correspondant au schéma
spécifié.
La valeur renvoyée est VRAI si un
fichier d'objet hôte correspondant au
schéma spécifié est trouvé. Le chemin
d'accès complet du fichier est stocké
dans pbstrFullQualName.
Page 75
Méthodes CHostDataManager
75Définitions d'objets Visual C++
Méthode
BOOL FindNext(BSTR
FAR* pbstrFullQualName);
LPDISPATCH
RetrieveObject(LPCTSTR
lpszFQName);
LPDISPATCH
RetrieveObject(short
wAccessMode);
valeur renvoyés
Parameter = BSTR
FAR *
pbstrFullQualName
Valeur renvoyée =
booléen
Parameter =
LPCTSTR
lpszFQName
Parameter = short
wAccessMode
DescriptionParamètre ou
Après l'appel réussi de FindFirst() pour
obtenir le nom d'un fichier d'objet hôte
dans ledossier encours, FindNext()peut
être appelé pour trouver le fichier
suivant correspondant au schéma.
Le paramètr est le tampon de retour
pour le chemin d'accès complet du
fichier d'objetdistant correspondantau
schéma spécifié dans l'appel initial de
FindFirst().
Renvoie la valeur VRAI si un autre
fichier d'objetdistant correspondantau
schéma spécifié dans l'appel de
FindFirst() esttrouvé. Lechemin d'accès
complet du fichier est stocké dans
pbstrFullQualName.
Récupère un objet CHostData par nom
de fichier.
Le paramètre est le nom intégralement
qualifié dufichier d'objethôte àcharger.
Spécifie comment cet objet doit être
utilisé. Ce paramètre est lié à la
protection parmot depasse. Lesoptions
sont les suivantes :
■ 0 = Non spécifié
■ 1 = Afficher uniquement
■ 2 = Afficher et modifier
■ 3 = Exécuter
LPDISPATCH
RetrieveObject(LPCTSTR
lpszPassword);
LPDISPATCH
RetrieveObject
LPCTSTR
lpszPassword
Valeur renvoyée =
LPDISPATCH
Mot de passe de l'objet.Peut être NULL.Parameter =
Pointeur surun objetenvoi OLE. L'objet
est un objet CHostData.
Le paramètre est le nom intégralement
qualifié dufichier d'objethôte àcharger.
Spécifie comment cet objet doit être
utilisé. Ce paramètre est lié à la
protection parmot depasse. Lesoptions
sont les suivantes :
■ 0 = Non spécifié
■ 1 = Afficher uniquement
■ 2 = Afficher et modifier
■ 3 = Exécuter
Mot de passe de l'objet.Peut être NULL.Parameter =
Pointeur surun objetenvoi OLE. L'objet
est un objet CHostDataEx.
Voir Exemple de code Visual C++ pour
la fonctionnalité Hôte.
LPDISPATCH
CreateObject(LPCTSTR
lpszName);
Parameter =
LPCTSTR
lpszFQName
Valeur renvoyée =
LPDISPATCH
Crée un objet CHostData et renvoie un
pointeur LPDISPATCH qui le désigne.
Le paramètre est le nom de fichier
entièrement qualifiéd'objet distantpour
le nouvel objet.
La valeurrenvoyée estun pointeurvers
un objet envoi OLE. L'objet est un objet
CHostData.
Voir Exemple de code Visual C++ pour
la fonctionnalité Hôte.
Page 77
objet CHostData
77Définitions d'objets Visual C++
Méthode
LPDISPATCH
CreateObjectEx(LPCTSTR
lpszName);
BOOL
DeleteObject(LPCTSTR
lpszFQName);
BOOL
DeleteObject(LPCTSTR
lpszPassword);
BOOL DeleteObject
valeur renvoyés
Parameter =
LPCTSTR
lpszFQName
Valeur renvoyée =
LPDISPATCH
Parameter =
LPCTSTR
lpszFQName
LPCTSTR
lpszPassword
booléen
DescriptionParamètre ou
Crée un objet CHostDataEx et renvoie
un pointeurLPDISPATCH quile désigne.
Le paramètre est le nom de fichier
entièrement qualifiéd'objet distantpour
le nouvel objet.
La valeurrenvoyée estun pointeurvers
un objet envoi OLE. L'objet est un objet
CHostDataEx.
Voir Exemple de code Visual C++ pour
la fonctionnalité Hôte.
Supprime un fichier d'objet hôte.
Le paramètre est le fichier objet hôte
entièrement qualifié de l'objet à
supprimer.
Mot de passe de l'objet.Peut être NULL.Parameter =
VRAI si l'objet est supprimé.Valeur renvoyée =
BOOL Launch(LPCTSTR
lpszFQName);
Parameter =
LPCTSTR
lpszFQName
Valeur renvoyée =
booléen
objet CHostData
Utilisez cet objet pour modifier les données de l'objet hôte.
Méthodes Get et Set (obtenir et définir)
Les méthodes suivantes servent à obtenir (Get) et définir (Set) les propriétés de
l'objet CHostData.
Lance un fichier d'objet hôte, ce qui
ouvre la fenêtre de terminal de l'hôte
pcAnywhere.
Le paramètre est le fichier objet hôte
entièrement qualifié de l'objet à lancer.
La valeur renvoyée est VRAI si l'objet
est lancé avec succès.
Page 78
Définitions d'objets Visual C++
78
objet CHostData
Le numérode téléphone est le numéro à composer pour établirune connexionpar
modem avec un ordinateur distant pcAnywhere.
BSTR GetPhoneNumber();
void SetPhoneNumber(LPCTSTR lpszNewValue);
Indique sides propriétésde numérotation TAPI doivent être utilisées (informations
d'emplacement) (VRAI) ou si la chaîne du numéro de téléphone doit être utilisée
exactement telle qu'elle apparaît (FAUX).
BOOL GetUseDialingProperties();
void SetUseDialingProperties(BOOL bNewValue);
Si lespropriétés de numérotation sont utilisées, il s'agitdu codede zone du numéro
à appeler.
BSTR GetAreaCode();
void SetAreaCode(LPCTSTR lpszNewValue);
Si les propriétés de numérotation sont utilisées,il s'agit de l'indicatif international
du numéro à appeler.
BSTR GetCountryCode();
void SetCountryCode(LPCTSTR lpszNewValue);
Nombre de tentatives d'appel de ce numéro si l'appel échoue.
short GetRedialCount();
void SetRedialCount(short nNewValue);
Délai en secondes entre les tentatives d'appel.
short GetRedialDelay();
void SetRedialDelay(short nNewValue);
Contrôle si les sessions utilisant cet objet sont consignées.
BOOL GetLogSession();
void SetLogSession(BOOL bNewValue);
Contrôle si les sessions utilisant cet objet sont enregistrées depuis le début.
BOOL GetRecordSession();
void SetRecordSession(BOOL bNewValue);
Nom du fichier d'enregistrement pour les sessions utilisant cet objet.
BSTR GetRecordFile();
void SetRecordFile(LPCTSTR lpszNewValue);
Page 79
Méthodes de détail d'objet hôte
Lorsqu'un typede connexion est affecté à un objethôte, lesdétails du périphérique
sont définis sur des valeurs par défaut valides.
Les typesde connexionsuivants possèdent des options de configuration avancées
qui peuvent être définies dans l'application :
■ Périphériques COM
■ Périphériques NetBIOS
■ Périphériques NASI/NCSI
■ Périphériques RNIS via CAPI 2.0 (RNIS européen seulement)
Détails de périphérique COM
Le code suivant place le type de connexion requis dans la liste des types de
connexion affectés à l'objet hôte et en fait le type de connexion en cours lors du
traitement ultérieur des appels de méthodes propres au périphérique.
BOOL AssignConnection(LPCTSTR lpszNewValue);
Si letype de connexion requis se trouve déjàdans la liste des connexions affectées,
celle-ci ne change pas. Seul le type de connexion actuel est remplacé par le type
demandé. Ilest normal d'appeler la méthode AssignConnection surle même objet
plusieurs fois lors de l'obtention et de la définition de valeurs propres à la
connexion.
AssignConnection renvoie VRAI si le type de connexion transmis existe sur
l'ordinateur et est affecté avec succès ou déjà affecté. Il renvoie FAUX si le type
de connexion requis n'existe pas sur l'ordinateur ou si le nombre de connexions
affectées a déjà atteint le maximum.
Un objethôte pcAnywherepeut prendreen chargejusqu'à deuxtypes deconnexion
affectés. Laméthode AssignConnection renvoie FAUX si elle détecte une tentative
de dépassement de cette limite.
Les types de connexion suivants sont disponibles :
■ COM1
objet CHostData
79Définitions d'objets Visual C++
■ COM2
■ COM3
■ COM4
■ SPX
■ NetBIOS
Page 80
Définitions d'objets Visual C++
80
objet CHostData
■ TCP/IP
■ RNIS via CAPI 2.0
■ DEFAULT TAPI
Le nom d'un périphérique TAPI peut également servir de type de connexion.
DEFAULT TAPIutilise le premier périphérique TAPItrouvé dansle système. Pour
utiliser un périphérique TAPI spécifique, utilisez FirstConnectionType() et
NextConnectionType() pour rechercher les périphériques disponibles.
Le code suivant désaffecte un type de connexion. Après avoir désaffecté un type
de connexion, la connexion affectée restante, s'il y en a une, devient le type de
connexion actuel pour les appels ultérieurs de méthode propres au périphérique.
BOOL UnassignConnection(LPCTSTR lpszNewValue);
Le code suivant définit la parité des communications :
BSTR GetComParity();
void SetComParity(LPCTSTR lpszNewValue);
Les valeurs de parité de communication sont les suivantes :
■ Aucune
■ Impaire
■ Paire
■ Marque
■ Espace
Le code suivant définit les niveaux de contrôle de flux :
Renvoie le nombre de types de connexion
disponibles sur cet ordinateur
FirstConnectionType() et
NextConnectionType() servent à itérer
parmi lestypesde connexiondisponibles.
Ces fonctions renvoient un BSTR qui est
le nomd'un typede connexiondisponible.
Les typesde connexionrenvoyés peuvent
être utilisés avec la fonction
SetConnectionType().
La valeur renvoyée est le nom d'un type
de périphérique de connexion pris en
charge.
Le paramètre est le nom d'un type de
périphérique de connexion
La valeur renvoyée est VRAIE si ce type
de périphérique est disponible
Renvoie le nombre maximum de types de
connexion qui peuvent être affectés
simultanément (actuellement deux).
short
AssignedConnections()
Valeur retournée
= Court
Renvoie le nombre de types de connexion
affectés.
Page 84
Définitions d'objets Visual C++
84
objet CHostData
Méthode
BSTR
FirstAssignedConnection();
et BSTR
NextAssignedConnection();
BSTR FirstCountryCode();
et BSTR
NextCountryCode();
valeur renvoyés
Valeur renvoyée
= BSTR
Paramètre =
LPCTSTR
lpszConnectionTyp
Valeur renvoyée
= booléen
Valeur retournée
= Court
Valeur renvoyée
= BSTR
DescriptionParamètre ou
FirstAssignedConnection() et
NextAssignedConnection() serventà itérer
parmi les connexions affectées. Ces
fonctions renvoient un BSTR, qui est le
nom d'un type de connexion affecté. Les
types deconnexion renvoyéspeuvent être
utilisés avec la fonction
AssignConnection().
La valeur renvoyée est le nom d'un type
de périphérique de connexion pris en
charge.
Le paramètre est le nom d'un type de
périphérique de connexion
La valeur renvoyée est VRAI si ce type de
périphérique est actuellement affecté
Renvoie le nombre d'indicatifs
internationaux disponibles.
FirstCountryCode() etNextCountryCode()
servent à itérer parmi la liste des
indicatifs internationauxdisponibles. Les
fonctions renvoient un BSTR qui est le
nom d'un indicatif international
disponible. Lesvaleurs renvoyéespeuvent
être utilisées avec la fonction
SetCountryCode().
La valeurrenvoyée est la première chaîne
d'indicatif international ou chaîne
suivante.
BOOL ReadObject(LPCTSTR
lpszPassword);
Parameter =
LPCTSTR
lpszPassword
Valeur renvoyée
= booléen
Lit les données d'objet à partir du fichier
d'objet hôte.
Le paramètre est le mot de passe objet
La valeur renvoyée est VRAI si l'objet est
lancé avec succès.
Page 85
objet CHostDataEx
85Définitions d'objets Visual C++
Méthode
BOOL
WriteObject(LPCTSTR
lpszPassword);
objet CHostDataEx
L'objet CHostDataEx contient la même fonction que l'objet CHostData, avec les
méthodes supplémentaires Get et Set (obtenir et définir) suivantes :
Ecrit les données d'objet dans le fichier
d'objet hôte.
Le paramètre est le mot de passe objet
La valeur renvoyée est VRAI si l'objet est
lancé avec succès.
Page 86
Définitions d'objets Visual C++
86
objet CHostDataEx
short GetAuthenticationType();
void SetAuthenticationType(short nNewValue);
BOOL GetLockSystemWhileWait();
void SetLockSystemWhileWait(BOOL bNewValue);
BOOL GetMinimizeOnLaunch();
void SetMinimizeOnLaunch(BOOL bNewValue);
BOOL GetRunAsService();
void SetRunAsService(BOOL bNewValue);
short GetConnLostWait();
void SetConnLostWait(short nNewValue);
BOOL GetConnLostHostOpts();
void SetConnLostHostOpts(BOOL bNewValue);
BOOL GetEnableConnLostSecurity();
void SetEnableConnLostSecurity(BOOL bNewValue);
short GetConnLostSecurity();
void SetConnLostSecurity(short nNewValue);
short GetCallbkDelay();
void SetCallbkDelay(short nNewValue);
BOOL GetEndSessHostOpts();
void SetEndSessHostOpts(BOOL bNewValue);
BOOL GetEnableEndSessSecurity();
void SetEnableEndSessSecurity(BOOL bNewValue);
short GetEndSessSecurity();
void SetEndSessSecurity(short nNewValue);
BSTR GetCryptPrivateKey();
void SetCryptPrivateKey(LPCTSTR lpszNewValue);
BSTR GetCryptCommonName();
void SetCryptCommonName(LPCTSTR lpszNewValue);
BOOL GetBlankHost();
void SetBlankHost(BOOL bNewValue);
BOOL GetAllowRemoteMouse();
void SetAllowRemoteMouse(BOOL bNewValue);
short GetRebootOnDisconnect();
void SetRebootOnDisconnect(short nNewValue);
BOOL GetPasswordAfterDisc();
void SetPasswordAfterDisc(BOOL bNewValue);
BOOL GetLogFailures();
void SetLogFailures(BOOL bNewValue);
BOOL GetAllowDriveSecurity();
void SetAllowDriveSecurity(BOOL bNewValue);
BOOL GetExecuteProtection();
void SetExecuteProtection(BOOL bNewValue);
Page 87
Exemple de code Visual C++ pour la fonctionnalité Hôte
L'exemple suivant de fonction Visual C++ crée un objet hôte, définit son type de
connexion surTCP/IP, définitle nomde l'ordinateur sur l'adresse TCP/IP transmise
à la fonction, puis lance l'objet hôte.
Le tableau suivant décrit les fonctions Awrem32, y compris les paramètres et les
valeurs renvoyées pour la gestion des connexions entre un hôte et un ordinateur
distant :
Méthode
boolean awConnect(BSTR
FileName);
boolean awDisconnect();
boolean
FileXferFromHost(BSTR
HostFile);
valeur renvoyés
Paramètre = Nom
comme chaîne
Valeur renvoyée=
booléen
Valeur renvoyée=
booléen
Paramètre =
HostFile comme
chaîne
DescriptionParamètre ou
Crée la connexion à l'ordinateur hôte.
Le paramètre est le nom intégralement
qualifié du fichier .chf contenant les
informations sur l'ordinateur hôte.
La valeur renvpyée exécute la
commande
Déconnecte l'ordinateur hôte.
Après avoir appelé cette fonction, le
programme appelant doit supprimer
l'objet (C++ - delete IAwrem32X*, VB –
set ObjectName = Nothing;).
Copie un fichier de l'ordinateur hôte
vers l'ordinateur distant. Les
paramètres peuvent contenir des
caractères génériques.
Le paramètrecontient lechemin d'accès
intégralement qualifié du fichier à
copier à partir de l'ordinateur hôte. Les
chaînes de fichier hôte et de fichier
distant ne sont pas obligatoirement
identiques.
boolean
FileXferFromHost(BSTR
RemoteFile);
boolean FileXferFromHost
Paramètre =
RemoteFile
comme chaîne
booléen
Copie un fichier de l'ordinateur hôte
vers l'ordinateur distant. Les
paramètres peuvent contenir des
caractères génériques.
Le paramètrecontient lechemin d'accès
de destination et le nom de fichier,
entièrement qualifiés. Les chaînes de
fichier hôte et de fichierdistant ne sont
pas obligatoirement identiques.
VRAI si la commande est exécutée.Valeur renvoyée=
Page 89
fonctions awrem32
89Définitions d'objets Visual C++
Méthode
boolean
FileXferToHost(BSTR
HostFile);
boolean
FileXferToHost(BSTR
RemoteFile);
boolean FileXferToHost
valeur renvoyés
Paramètre =
HostFile comme
chaîne
Paramètre =
RemoteFile
comme chaîne
booléen
DescriptionParamètre ou
Copie un fichier de l'ordinateur distant
vers l'ordinateur hôte. Les paramètres
peuvent contenir des caractères
génériques.
Le paramètrecontient lechemin d'accès
de destination et le nom de fichier,
entièrement qualifiés. Les chaînes de
fichier hôte et de fichierdistant ne sont
pas obligatoirement identiques.
Copie un fichier de l'ordinateur distant
vers l'ordinateur hôte. Les paramètres
peuvent contenir des caractères
génériques.
Le paramètrecontient lechemin d'accès
intégralement qualifié du fichier à
copier à partir de l'ordinateur distant.
Les chaînes de fichier hôte et de fichier
distant ne sont pas obligatoirement
identiques.
VRAI si la commande est exécutée.Valeur renvoyée=
boolean
CreateFolderOnHost(BSTR
FolderName);
Paramètre = Nom
de dossier comme
chaîne
Valeur renvoyée=
booléen
Crée unnouveau dossiersur l'ordinateur
hôte. Cette fonction crée un dossier
temporaire surl'ordinateur distant,puis
copie ce dossier sur l'ordinateur hôte.
Ce paramètre contient le lecteur et le
chemin d'accès du dossier sur
l'ordinateur hôte.
La valeur renvoyée est VRAI si la
commande est exécutée.
Page 90
Définitions d'objets Visual C++
90
fonctions awrem32
Méthode
boolean
ExecuteHostFile(BSTR
FileName);
BSTR GetError();
short ConnectionStatus();
valeur renvoyés
Paramètre = Nom
de fichier comme
chaîne
Valeur renvoyée=
booléen
Valeur renvoyée=
Chaîne
Valeur retournée
= Court
DescriptionParamètre ou
Exécute un fichier existant sur
l'ordinateur hôte.Cette fonctionne peut
exécuter que les fichiers batch, de
commandes et exécutables. Elle
n'exécute pas les fichiers associés aux
exécutables. Par exemple, elle n'ouvre
pas MicrosoftWord sivous exécutez un
fichier .doc.
Contient le chemin d'accès
intégralement qualifié du fichier sur
l'ordinateur hôte.
La valeur renvoyée est VRAI si la
commande est exécutée.
Renvoie ladernière erreurgénérée dans
Awrem32, comme chaîne.
Renvoie l'état courant de la connexion
à l'ordinateur hôte.
Les valeurspossibles sontles suivantes:
■ -1 = Connexion perdue
■ 0 = Aucune connexion
■ 1 = Session connectée
Page 91
Index
A
automatisation OLE. Se reporter à serveur
d'automatisation pcAnywhere
Awrem32
fonctions 58, 88
B
bibliothèques API 14
bibliothèques de type 14
C
C++.. Se reporter à Visual C++
CHostData
utilisation de Visual Basic 37
utilisation de Visual C++ 77
CHostDataEx
utilisation de Visual Basic 48
utilisation de Visual C++ 85
CHostDataManager
utilisation de Visual Basic 34
utilisation de Visual C++ 73
connexions
arrêt 58, 88
démarrage 37, 58, 65, 88
erreurs de retour 90
retour de l'état 60, 90
connexions CAPI
propriétés de l'hôte 48, 83
propriétés des distants 30, 70
connexions NetBIOS
propriétés de l'hôte 47, 82
propriétés des distants 29, 70
connexions par modem
sur l'hôte
indicatifs internationaux 84
périphériques TAPI 80
propriétés COM 44, 79
propriétés de numérotation 43
sur l'ordinateur distant
indicatifs internationaux 71
périphériques TAPI 68
propriétés COM 26, 68
propriétés de numérotation 25
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