SLI_STSN_ROUTINE動詞命令會通知Microsoft® Windows® 邏輯單元應用程式 （LUA） 應用程式 STSN 命令來自主機，並允許使用者提供的例程檢查要求並制定回應。
下列結構描述SLI_STSN_ROUTINE所使用的動詞控制區塊 （VCB） LUA_COMMON成員。
語法
struct LUA_COMMON {
unsigned short lua_verb;
unsigned short lua_verb_length;
unsigned short lua_prim_rc;
unsigned long lua_sec_rc;
unsigned short lua_opcode;
unsigned long lua_correlator;
unsigned char lua_luname[8];
unsigned short lua_extension_list_offset;
unsigned short lua_cobol_offset;
unsigned long lua_sid;
unsigned short lua_max_length;
unsigned short lua_data_length;
char FAR * lua_data_ptr;
unsigned long lua_post_handle;
struct LUA_TH lua_th;
struct LUA_RH lua_rh;
struct LUA_FLAG1 lua_flag1;
unsigned char lua_message_type;
struct LUA_FLAG2 lua_flag2;
unsigned char lua_resv56[7];
unsigned char lua_encr_decr_option;
};
成員
lua_verb
提供的參數。 包含動詞程式代碼，LUA_VERB_SLI會話層級介面 （SLI） 動詞命令。
lua_verb_length
提供的參數。 指定 LUA VCB 的位元組長度。 它必須包含所發出動詞記錄的長度。
lua_prim_rc
LUA 在動詞完成時設定的主要傳回碼。 有效的傳回碼會根據所發出的 LUA 動詞而有所不同。
lua_sec_rc
LUA 在動詞完成時所設定的次要傳回碼。 有效的傳回碼會根據所發出的 LUA 動詞而有所不同。
lua_opcode
提供的參數。 包含要發出動詞的 LUA 命令程式代碼（動詞作業程式代碼），LUA_OPCODE_SLI_STSN_ROUTINE。
lua_correlator
提供的參數。 包含使用者提供的值，這個值會鏈接動詞與其他使用者提供的資訊。 LUA 不會使用或變更這項資訊。 這是選擇性參數。
lua_luname
提供的參數。 指定 Windows LUA 工作階段所使用的本機 LU 的 ASCII 名稱。
SLI_STSN_ROUTINE只有在lua_sid為零時，才需要此參數。
如果名稱短於八個字元，則此參數長度為8個字節，以空格（0x20）填補右邊。
lua_extension_list_offset
SLI_STSN_ROUTINE未 使用 ，且 應設定為零。
lua_cobol_offset
MICROSOFT主機整合伺服器或 SNA 伺服器中®未使用 LUA，且應為零。
lua_sid
提供的參數。 指定會話標識碼，並由 SLI_OPEN 和 RUI_INIT傳回。 其他動詞會使用此參數來識別用於命令的會話。 如果其他動詞使用 lua_luname 參數來識別會話，請將 lua_sid 參數設定為零。
lua_max_length
SLI_STSN_ROUTINE未 使用 ，且 應設定為零。
lua_data_length
傳回的參數。 指定數據緩衝區中傳回之 STSN 要求/回應單位 （RU） 數據的長度。
lua_data_ptr
針對 SLI_STSN_ROUTINE 此參數包含 STSN RU 的位址。
lua_post_handle
提供的參數。 如果事件要完成異步通知，則用於Microsoft Windows Server。 此變數包含要發出訊號的事件句柄或視窗句柄。
對於所有其他環境，此參數是保留的，而且應該設定為零。
lua_th
傳回的參數。 包含所接收訊息的 SNA 傳輸標頭 （TH）。 讀取和投標函式會傳回各種子參數。
lua_rh
傳回的參數。 包含已傳送或接收之訊息的 SNA 要求 /回應標頭 （RH）。
lua_flag1
提供的參數。 包含包含應用程式所提供訊息旗標的資料結構。
lua_message_type
提供的參數。 指定傳送至主機的 SNA 資料或命令類型。
lua_flag2
傳回的參數。 包含 LUA 所傳回之訊息的旗標。
lua_flag2.async
指出如果設定為 1，LUA 介面動詞動詞會以異步方式完成。
lua_flag2.sscp_exp
如果設定為 1，表示系統服務控制點 （SSCP） 加速流程。
lua_flag2.sscp_norm
如果設定為 1，則表示 SSCP 一般流程。
lua_flag2.lu_exp
如果設定為 1，則表示 LU 加速流程。
lua_flag2.lu_norm
如果設定為 1，則表示 LU 一般流程。
lua_resv56
保留且應設定為零。
lua_encr_decr_option
SLI_STSN_ROUTINE未 使用 ，且 應設定為零。
回傳代碼
LUA_OK
主要傳回碼;已順利執行動詞。
LUA_SEC_OK
次要傳回碼;LUA_OK沒有其他資訊存在。
LUA_NEGATIVE_RSP
主要傳回碼;LUA 會傳送負面回應給從主要邏輯單元 （PLU） 接收的訊息，因為訊息中發現錯誤，或應用程式對鏈結結束到達的鏈結做出負面回應。
備註
SLI_STSN_ROUTINE 提供 Windows LUA 應用程式檢查及回應 STSN 命令的機制。 Windows LUA 會通知 Windows LUA 應用程式 STSN 命令已從主機接收。 這是透過使用者提供的動態連結庫 （DLL） 來完成。 使用者 DLL 會檢查 STSN 要求，並制定對要求的回應。
例程的 DLL 名稱會以 SLI_OPEN 動詞 VCB 的延伸模組的形式提供。 lua_extension_list_offset參數會提供 VCB 開頭到延伸模組清單中的名字的位移。
Windows LUA 介面會指派 VCB 結構化的儲存空間。 SLI_STSN_ROUTINE的 VCB 包含lua_th和lua_rh。 STSN RU 的位址是在 lua_data_ptr 中指定，而 RU 的長度則指定於 lua_data_length。
當SLI_STSN_ROUTINE返回 Windows LUA 時，會完成SLI_STSN_ROUTINE的處理。 STSN 回應應該覆寫 STSN RU。 接受 STSN 時，主要傳回碼應該設定為 LUA_OK。 如果 STSN 遭到拒絕，主要傳回碼應該設定為 LUA_NEGATIVE_RSP，而 STSN 緩衝區包含負感代碼。 不應修改lua_data_ptr參數。
如果從SLI_STSN_ROUTINE傳回負回應， 則會取消SLI_OPEN 。 SLI_OPEN的lua_prim_rc會設定為 LUA_SESSION_FAILURE，且lua_sec_rc設定為 LUA_NEG_RSP_FROM_STSN_ROUTINE。
另請參閱
RUI_INIT
RUI_PURGE
RUI_READ
RUI_WRITE
SLI_OPEN
SLI_PURGE
SLI_RECEIVE
SLI_SEND