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 包含主機整合伺服器的版本號、目前設定檔的路徑,以及主機整合伺服器所運行的網路作業系統。
若沒有可用的設定檔伺服器,則只有版本號欄位有效;其他欄位則不應該被勾選。