PgExToolReadValue

Cette fonction permet de lire la valeur associée à une section et une clé dans le fichier de données.

ALPHA(256)	Fichier	Nom complet du fichier de données.
ALPHA(n)	Section	Section.
ALPHA(n)	Cle	Clé.
ALPHA(n)	Valeur	Valeur récupérée par la fonction dans le fichier.
NUM_BIN_4	TailleValeur	Taille de Valeur : n.
NUM_BIN_4	CodeRetour	Code retour de lecture (mis à jour par la fonction).

0	Lecture réussie : Valeur est alors renseignée.
1	Lecture tronquée : Valeur est alors renseignée mais n'est pas assez grande pour contenir toute l'information présente dans le fichier (revoir la valeur de n).

Echec lors de la lecture : Valeur est retournée à blanc.

-1	Fichier de données non trouvé.
-2	Section invalide : - soit Section est vide, - soit Section est une section élément invalide d'une liste (incompatible avec le nombre d'éléments de la liste), - soit le fichier de données est un fichier paramètre destiné à un programme EXIT et Section ne fait pas partie des sections autorisées.
-3	Clé incompatible avec Section : contrôle exclusivement effectué si le fichier de données est un fichier paramètre destiné à un programme EXIT.
-99	Valeur non trouvée : le fichier de données ne contient pas de valeur associée à Section et Clé.

/* Cet exemple correspond à une lecture 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)	Section
ALPHA(40)	Cle
ALPHA(200)	Valeur
NUM_BIN_4	TailleValeur
NUM_BIN_4	CodeRetour

Section = 'PARAM_UTILISATEUR'

Cle = 'VALEUR'

TailleValeur = 200

/* lecture de la valeur du paramètre utilisateur dans le fichier paramètre

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

Cliquez ci-dessous pour plus d'informations sur :