sbpuinit

sbpuinit函式會初始化 DL-BASE。

語法

  
USHORT sbpuinit(   
HANDLE *sema4ptr,   
USHORT proctype,   
USHORT servtype,   
UCHAR *uname   
);  

參數

sema4ptr
動態存取模組所建立的旗號 (DMOD) ,當訊息可用時,DMOD 會清除。 此位址供主機整合伺服器內部使用。 應用程式不應該後續嘗試參考位址。

proctype
進程類型:CLIENT–2。

servtype
服務/用戶端的類型:CES3270–2。

uname
長度至少為 21 個字元的字元緩衝區指標;LAN Manager 使用者名稱或其他適合網路作業系統的識別名稱,會傳回給此緩衝區中的應用程式。 應用程式不需要使用此參數,但可用於顯示或記錄。

傳回值

NO_ERROR
初始化成功。

任何其他傳回值都表示初始化失敗。 這通常是作業系統傳回碼。 也會使用下列值:

DMLTABF (555)
L 資料表已滿。

DMMNWGI (562)
無法取得網路作業系統資訊。

DMDSTFL (563)
服務資料表已滿。

DMMPIPF (567)
無法建立具名管道。

DMCOMNM (582)
此應用程式未註冊任何名稱。

DMCOMDUP (596)
服務已經在使用相同的名稱執行。

DMNOTLOG (598)
使用者未登入網路作業系統。

DMCFGOPN (616)
無法開啟組態檔。

DMCFGREAD (618)
無法從組態檔讀取。

DMNONAP (625)
未啟動網路存取計畫 (NAP) 。

DMMAXAPP (953)
僅限 Windows:超過並行應用程式的數目上限。

備註

除了 SNAGetVersion以外的任何其他 DL-BASE 或 DMOD 進入點之前,應該一律呼叫sbpuinit進入點。 針對新的模擬器,應該在sbpuinit之後呼叫sepdcrec。 (由於舊版模擬器中使用的呼叫順序,因此仍支援sbpuinit之前的sepdcrec呼叫,但不建議使用此順序。)