Listimp
Listimp permet de récupérer la liste des noms d'imprimantes rattachées à un serveur d'impression ou au poste client.
Syntaxe
Listimp param = id_serveur
Paramètres
Elément | Description | Restrictions |
param |
|
|
id_serveur | identification du serveur d'impression sous la forme : |
|
Exemples
Local Char PARAMETRE(250)(1..100)
Local Char SERVEUR(30)
Local Char TEXTE(250)(1..50)
Local Integer ITT,RG,NBIMP,NBTEX# Exemple : récupération du nom des imprimantes attachées
# au serveur d'impression.
SERVEUR="impser.com:1969@"
Listimp PARAMETRE = SERVEUR
RG=instr(1,PARAMETRE(1),chr$(1))
NBIMP=val(num$(ascii(mid$(PARAMETRE(1),RG+1,1))))
Raz TEXTE,TEX,NBTEX
For ITT=1 To NBIMP
RG=instr(1,PARAMETRE(ITT+1),chr$(1))
NBTEX+=1
TEXTE(NBTEX)=mid$(PARAMETRE(ITT+1),RG+1,len(PARAMETRE(ITT+1)))
If ITT=50 : Break 1 : Endif
Next ITT
Description
Listimp permet de choisir un serveur d'impression pour avoir en retour les informations sur les imprimantes associées. Si le serveur d'impression n'est pas renseigné, on aura les informations des imprimantes associées au poste client.
Le 1er paramètre param contient l'ensemble des données retournées par l'instruction. Dans le premier poste de la table param , on obtient le nombre d'imprimantes définies sur le serveur d'impression ( ou poste client ). Dans les postes suivants, on a le nom de ces imprimantes ( c'est à dire le _PrinterName tel qu'il est défini dans l'instruction Selimp).
Le 2ème paramètre id_serveur contient la chaîne d'identification du serveur d'impression sur le réseau. Cette chaîne comporte une partie obligatoire et une partie facultative ( en italique ci-dessous ) "machine.domaine:port@"
Exemple :
Listimp PARAMETRE = "impser.com:1969@"
Listimp PARAMETRE = "impser.com"
Si la partie facultative n'est pas renseignée, alors par défaut, la communication avec le serveur d'impression sera établie en utilisant le port de connexion courant de la session X3 exécutant l'instruction "Listimp".
Pour avoir les imprimantes définies sur le poste client :
Listimp PARAMETRE = ""