SEPDGETINFO

sepdgetinfo 函式回傳一個結構,包含主機整合伺服器的版本號、目前設定檔的路徑,以及主機整合伺服器所運行的網路作業系統。

語法

  
USHORT sepdgetinfo(   
struct cs_info *pCSInfo   
);  

參數

pCSInfo
指標指向應用程式提供的緩衝區,包含一個 cs_info 資料結構,系統資訊會在此回傳。 應用程式必須在此資料結構中設定 成員長度 (更多資訊請參見本主題後續的備註);其他成員應設為空值或空白。

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;  

成員

長度
應用程式所提供的資料結構長度。

major_ver
主要版本號:

1 用於主機整合伺服器 1.1(連接伺服器 1.1) 2 用於主機整合伺服器 2.0(連接伺服器 2.0)

minor_ver
次要版本號(小數點):

10 表示連接伺服器 1.1(表示 1.10)00,表示連接伺服器 2.0(表示 2.00)

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

不
網路作業系統

1:區域網路管理員

傳回值

NO_ERROR (0)
OK.

NOCSSRVR(1)
沒有設定檔伺服器可用。

巴德林斯(2)
提供的緩衝區太小。

備註

應用程式必須將 長度 成員設定為 cs_info 結構的長度(目前版本為 86 位元組)。 其他數值都會被拒絕。 此參數用於確保與未來版本的相容性;提供此長度的應用程式將永遠取得此處所示資訊,但在未來版本中,可能可指定更大值並取得更多資訊。

成功返回時,資料結構 cs_info 包含主機整合伺服器的版本號、目前設定檔的路徑,以及主機整合伺服器所運行的網路作業系統。

若沒有可用的設定檔伺服器,則只有版本號欄位有效;其他欄位則不應該被勾選。