Téléchargement des produits


Version anglaise


 

 

Cette fonction permet de récupérer la section correspondant à l'élément précédent de la liste définie par la section donnée en paramètre, dans le fichier de données.

 

Remarque importante : la dll PgExTool doit être chargée (ordre CHARGER_DLL) en début de programme et doit rester chargée au moment de l'appel des fonctions de gestion de listes de sections.

 

Paramètres

ALPHA(256)

Fichier

Nom complet du fichier de données.

ALPHA(n)

SectionListe

Section liste.

ALPHA(n)

SectionElt

Section élément de liste (mis à jour par la fonction) de type SectionListe#numéro ; il faut donc prévoir SectionElt plus grand que ce que contient SectionListe.

NUM_BIN_4

TailleSection

Taille de SectionElt : n.

NUM_BIN_4

CodeRetour

Code retour de lecture (mis à jour par la fonction).

 

Valeurs possibles du code retour

0

Lecture réussie : SectionElt est alors renseignée et contient une section qui peut être utilisée dans les fonctions PgExToolReadValue et PgExToolWriteValue.

 

Echec lors de la récupération de l'élément de la liste : SectionElt est retournée à blanc.

-1

Fichier paramètre non trouvé.

-2

SectionListe invalide :

- soit SectionListe est vide,

- soit le fichier de données est un fichier paramètre destiné à un programme EXIT et SectionListe ne fait pas partie des sections autorisées.

-4

SectionElt est trop petit pour recevoir le résultat de la fonction.

-10

L'élément de liste souhaité n'existe pas :

- soit le précédent positionnement dans la liste était sur le premier élément de la liste ; par conséquent, il n'y a pas l'élément précédent. Dans ce cas, la fonction PgExToolItemSectionInUse retourne le premier élément de la liste.

- soit aucun positionnement dans la section liste n'a été effectué précédemment ; par conséquent, le positionnement sur l'élément précédent n'est pas autorisé.

 

Exemple

/* Cet exemple correspond au parcours d'une liste dans un fichier paramètre

/* destiné à un programme EXIT lors d'une validation de correction

ALPHA(256)

FicParam

 

PARAM

FicParam

/* paramètre d'appel du programme EXIT

ALPHA(40)

SectionListe

ALPHA(50)

SectionElt

NUM_BIN_4

TailleSection

NUM_BIN_4

CodeRetour

ALPHA(40)

Cle

ALPHA(200)

Valeur

 

 

/* Début de programme : chargement de la dll PgExTool

CHARGER_DLL 'PgExTool'

/* Parcours inverse de la liste des objets reçus lors de la validation

/* de correction

 

SectionListe = 'OBJET_RECU'

TailleSection = 50

 

/* lecture de la dernière section élément de la liste

APPELER_DLL 'PgExTool' 'PgExToolLastItemSection' FicParam SectionListe SectionElt TailleSection CodeRetour

 

TANT_QUE CodeRetour = 0

/* il est alors possible de lire des paramètres liés à l'objet reçu

/* grâce à SectionElt, par exemple le nom de l'objet reçu :

Cle = 'NOM'

TailleValeur = 200

APPELER_DLL 'PgExTool' 'PgExToolReadValue' FicParam SectionElt Cle Valeur TailleValeur CodeRetour

...

...

/* lecture de la section élément précédente (objet reçu précédent)

APPELER_DLL 'PgExTool' 'PgExToolPreviousItemSection' FicParam SectionListe SectionElt TailleSection CodeRetour

REFAIRE

/* Fin de programme : déchargement de la dll PgExTool

DECHARGER_DLL 'PgExTool'

 

 

Cliquez ci-dessous pour plus d'informations sur :

 

↑ Haut de page

  • Aucune étiquette