sepdgetinfo

  • 發行項

sepdgetinfo函式會傳回結構，其中包含主機整合伺服器的版本號碼、目前組態檔的路徑，以及主機整合伺服器執行所在的網路作業系統。

語法

  
USHORT sepdgetinfo(   
struct cs_info *pCSInfo   
);

參數

pCSInfo
應用程式所提供的緩衝區指標，其中包含傳回系統資訊的 cs_info 資料結構。 應用程式必須設定此資料結構中的 長度 成員 (以取得詳細資訊，請參閱本主題稍後的) ;其他成員應該設定為 Null 或空白。

cs_info 結構

傳回 的 cs_info 結構及其成員如下所示：

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

成員

length (長度)
應用程式提供的資料結構長度。

major_ver
主要版本號碼：

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

minor_ver
次要版本號碼 (十進位) ：

10 表示連線伺服器 1.1 (表示連線伺服器 2.0) 00 (指出 2.00)

config_share[80]
執行中組態檔 : \\server\share\ (null 終止) 的路徑。

Nos
使用中的網路作業系統

1：LAN 管理員

傳回值

NO_ERROR (0)
正常。

NOCSSRVR (1)
沒有可用的組態檔伺服器。

BADLNGTH (2)
提供的緩衝區太小。

備註

應用程式必須將 長度 成員設定為目前版本 ) 中 ( 86 個位元組的cs_info結構長度。 任何其他值都會遭到拒絕。 此參數可用來確保與未來的版本相容;提供此長度的應用程式一律會取得這裡顯示的資訊，但在未來的版本中，可能可以指定較大的值並取得進一步的資訊。

成功傳回時，資料結構 cs_info 包含主機整合伺服器的版本號碼、目前組態檔的路徑，以及主機整合伺服器執行所在的網路作業系統。

如果沒有可用的組態檔伺服器，則只有版本號碼欄位有效;不應該檢查其他欄位。