sepdcrec

Sepdcrec函式會取得設定資訊。 應用程式會呼叫此函式,以取得使用者用來登入網路作業系統之名稱的3270設定資訊。 呼叫也會在服務資料表中註冊這個使用者名稱。

語法

  
USHORT sepdcrec(   
UCHAR *pBuffer,  
USHORT length,  
USHORT *numbytes  
);  

參數

pBuffer
應用程式所提供之緩衝區的指標,其中會傳回設定資訊。

length (長度)
提供的緩衝區大小。

numbytes
由 Host Integration Server 用來傳回緩衝區中傳回的資訊位元組數目。

傳回值

NO_ERROR (0)
正常。

NOCSSRVR (1)
沒有任何可用的配置檔案伺服器。

NODGNREC (2)
在設定檔中找不到任何診斷記錄。

NOUSRREC (3)
在設定檔中找不到此使用者的任何使用者記錄。

BUF2SMAL (4)
提供的緩衝區太小。

NONOS (5)
未啟動網路作業系統。

NOTLOGON (6)
使用者未登入網路作業系統。

READERR (7)
無法讀取設定檔案。

NONAP (8)
未啟動 (NAP) 的網路存取程式。

MAXAPP (9)
僅限 Windows:已超過並行應用程式的最大數目。

ERROR_SERVER (14)
遠端程序呼叫的伺服器端發生錯誤 (RPC) 。

ERROR_LOCAL_FAILURE (15)
RPC 的本機端發生錯誤。

備註

Sbpuinit函式應該一律在任何其他 DL 基底或動態存取模組之前呼叫 (DMOD) 進入點,但SNAGetVersion除外。 若為新的模擬器,則應該在sbpuinit之後呼叫sepdcrec 。 (因為舊版模擬器中使用的呼叫順序,仍支援在sbpuinit之前呼叫sepdcrec ,但不建議使用此順序。 )

在成功傳回時,緩衝區會包含適當3270使用者記錄和診斷記錄的指標,後面接著記錄本身。 格式如下:

TECWRKUS *pUserRecord,   
TEDIAGNS *pDiagRecord   
);  

(UserRecord —變數長度)

(DiagRecord)

您應該使用提供的指標來存取這兩筆記錄。

請參閱設定 資訊 ,以取得這些記錄格式的詳細資料,以及應用程式如何使用設定檔資訊的詳細資訊。

如果設定檔中沒有此使用者的3270使用者記錄,或在設定檔中找不到任何診斷記錄 (內部錯誤) ,則應用程式應該會終止,而且不允許使用者使用3270模擬。 Host Integration Server 錯誤記錄檔訊息 COM0438 和 COM0437 可以用來報告這些失敗。

如果提供的緩衝區對傳回的資訊而言太小,則緩衝區的內容是未定義的,而且不應該檢查,但是 numbytes 參數會包含可用的資訊位元組總數 (也就是這兩個指標的大小,再加上兩個設定記錄) 。 應用程式應該使用至少此大小的緩衝區重試。