sepdgetinfo

The sepdgetinfo function returns a structure containing the version number of SNA Server, the path of the current configuration file, and the network operating system over which SNA Server is running.

Win32

USHORT sepdgetinfo(

    struct cs_info *pCSInfo 






   );









MS-DOS, Windows Version 3.x, and OS/2



USHORT FAR sepdgetinfo(





    struct cs_info FAR *pCSInfo







   );









Parameters





pCSInfo



Pointer to a buffer supplied by the application, containing a data structure in which system information is returned. The application must set the length member in this data structure (see Remarks below); the other members should be set to nulls or blanks.






The returned cs_info structure and its members are as follows:


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


Members





length



Length of the data structure supplied by the application.



major_ver



Major version number:


1 for CS 1.1 

2 for CS 2.0





minor_ver



Minor version number (decimal):


10 for CS 1.1 (indicates 1.10)

00 for CS 2.0 (indicates 2.00)





config_share[80]



Path of the running configuration file: \\server\share\ (null terminated).



nos



Network operating system in use 


1: LAN Manager / LAN Server

2: NetWare






Return Values





NO_ERROR  (0)



OK.



NOCSSRVR  (1)



No configuration file server available.



BADLNGTH  (2)



Supplied buffer was too small.





Remarks



The application must set the length member to the length of the cs_info structure (86 bytes in the current version). Any other value will be rejected. This parameter is used to ensure compatibility with future versions; an application supplying this length will always obtain the information shown here, but in future versions it may be possible to specify larger values and obtain further information.



On successful return, the data structure cs_info contains the version number of SNA Server, the path of the current configuration file, and the network operating system over which SNA Server is running.



Do not use the configuration file path returned by sepdgetinfo because NetWare clients will not be able to access this path.



If there is no configuration file server available, only the version number fields are valid; the other fields should not be checked.