sepdgetinfo

Fungsi sepdgetinfo mengembalikan struktur yang berisi nomor versi Host Integration Server, jalur file konfigurasi saat ini, dan sistem operasi jaringan tempat Server Integrasi Host berjalan.

Sintaks

  
USHORT sepdgetinfo(   
struct cs_info *pCSInfo   
);  

Parameter

pCSInfo
Penunjuk ke buffer yang disediakan oleh aplikasi, berisi struktur data cs_info tempat informasi sistem dikembalikan. Aplikasi harus mengatur anggota panjang dalam struktur data ini (untuk informasi selengkapnya, lihat Keterangan nanti dalam topik ini); anggota lain harus diatur ke null atau kosong.

Struktur cs_info

Struktur cs_info yang dikembalikan dan anggotanya adalah sebagai berikut:

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

Anggota

length
Panjang struktur data yang disediakan oleh aplikasi.

major_ver
Nomor versi utama:

1 untuk Host Integration Server 1.1 (Connection Server 1.1) 2 untuk Host Integration Server 2.0 (Connection Server 2.0)

minor_ver
Nomor versi minor (desimal):

10 untuk Connection Server 1.1 (menunjukkan 1.10)00 untuk Connection Server 2.0 (menunjukkan 2.00)

config_share[80]
Jalur file: konfigurasi yang sedang berjalan \\server\share\ (null dihentikan).

Nos
Sistem operasi jaringan yang digunakan

1: Manajer LAN

Tampilkan Nilai

NO_ERROR (0)
OK.

NOCSSRVR (1)
Server file konfigurasi tidak tersedia.

BADLNGTH (2)
Buffer yang disediakan terlalu kecil.

Keterangan

Aplikasi harus mengatur panjang anggota ke panjang struktur cs_info (86 byte dalam versi saat ini). Nilai lainnya akan ditolak. Parameter ini digunakan untuk memastikan kompatibilitas dengan versi mendatang; aplikasi yang menyediakan panjang ini akan selalu mendapatkan informasi yang ditunjukkan di sini, tetapi dalam versi mendatang mungkin untuk menentukan nilai yang lebih besar dan mendapatkan informasi lebih lanjut.

Setelah berhasil dikembalikan, struktur data cs_info berisi nomor versi Host Integration Server, jalur file konfigurasi saat ini, dan sistem operasi jaringan tempat Server Integrasi Host berjalan.

Jika tidak ada server file konfigurasi yang tersedia, hanya bidang nomor versi yang valid; bidang lain tidak boleh diperiksa.