SNAGetConfigValue

SNALink appelle la fonction SNAGetConfigValue pour obtenir la valeur d’un paramètre de configuration spécifique.

Syntaxe

  
USHORT SNAGetConfigValue(  
UCHAR *entryName,  
VOID *pBuffer,  
ULONGbufferLen,  
UCHARparmType,  
ULONG *pRetLength  
);  

Paramètres

entryName
Nom du paramètre de configuration requis.

pBuffer
Pointeur vers une mémoire tampon (si le paramètre est une chaîne) ou pointeur vers un LONGINT (si le paramètre est un entier).

bufferLen
Longueur de la mémoire tampon. Obligatoire uniquement si le paramètre est TYPESTRING.

parmType
TYPESTRING si le paramètre est une chaîne.

TYPELONG si le paramètre est un entier.

pRetLength
Nombre d’octets retournés si le paramètre est TYPESTRING ou le nombre d’octets disponibles si la mémoire tampon était trop courte.

Valeur renvoyée

NO_ERROR
OK.

ERBADCFG
Erreur lors de la lecture du fichier de configuration.

ERNOTFND
Entrée introuvable dans l’enregistrement de configuration.

ERTOOLONG
Les données disponibles ont dépassé la taille de la mémoire tampon.

ERBADTYPE
Un type incorrect a été spécifié pour le paramètre parmType .

Remarques

Il est fortement recommandé que SNALink lise tous les paramètres de configuration requis au moment de l’initialisation (lorsque SNALinkInitialize est appelé par la base).