sepdgetinfo

Article
10/14/2023

La fonction sepdgetinfo retourne une structure contenant le numéro de version de Host Integration Server, le chemin du fichier de configuration actuel et le système d’exploitation réseau sur lequel Host Integration Server s’exécute.

Syntaxe

  
USHORT sepdgetinfo(   
struct cs_info *pCSInfo   
);

Paramètres

pCSInfo
Pointeur vers une mémoire tampon fournie par l’application, contenant une structure de données cs_info dans laquelle les informations système sont retournées. L’application doit définir le membre de longueur dans cette structure de données (pour plus d’informations, voir Remarques plus loin dans cette rubrique) ; les autres membres doivent avoir la valeur null ou vide.

Structure cs_info

La structure cs_info retournée et ses membres sont les suivants :

struct cs_info {  
    unsigned short length;  
    unsigned char  major_ver;  
    unsigned char  minor_ver;  
    unsigned char  config_share[80];  
    unsigned short nos;  
 } cs_info;

Membres

length
Longueur de la structure de données fournie par l’application.

major_ver
Numéro de version principale :

1 pour Host Integration Server 1.1 (Serveur de connexion 1.1) 2 pour Host Integration Server 2.0 (Serveur de connexion 2.0)

minor_ver
Numéro de version secondaire (décimal) :

10 pour le serveur de connexion 1.1 (indique 1.10)00 pour le serveur de connexion 2.0 (indique 2.00)

config_share[80]
Chemin du fichier: de configuration en cours d’exécution \\server\share\ (null terminé).

nos
Système d’exploitation réseau en cours d’utilisation

1 : GESTIONNAIRE DE RÉSEAU

Valeur renvoyée

NO_ERROR (0)
OK.

NOCSSRVR (1)
Aucun serveur de fichiers de configuration disponible.

BADLNGTH (2)
La mémoire tampon fournie était trop petite.

Remarques

L’application doit définir le membre de longueur sur la longueur de la structure cs_info (86 octets dans la version actuelle). Toute autre valeur sera rejetée. Ce paramètre est utilisé pour garantir la compatibilité avec les versions ultérieures ; une application fournissant cette longueur obtiendra toujours les informations affichées ici, mais dans les versions ultérieures, il sera possible de spécifier des valeurs plus grandes et d’obtenir des informations supplémentaires.

En cas de retour réussi, la structure de données cs_info contient le numéro de version de Host Integration Server, le chemin d’accès du fichier de configuration actuel et le système d’exploitation réseau sur lequel Host Integration Server s’exécute.

Si aucun serveur de fichiers de configuration n’est disponible, seuls les champs de numéro de version sont valides ; Les autres champs ne doivent pas être vérifiés.

Partager via