SLI_PURGE動詞會取消SLI_RECEIVE發出等候條件的動詞。
下列結構描述SLI_PURGE所使用的動詞控制區塊 （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_PURGE。
lua_correlator
提供的參數。 包含使用者提供的值，這個值會鏈接動詞與其他使用者提供的資訊。 LUA 不會使用或變更這項資訊。 這是選擇性參數。
lua_luname
提供的參數。 指定 Windows LUA 工作階段所使用的本機 LU 的 ASCII 名稱。
SLI_PURGE只有在lua_sid為零時，才需要此參數。
如果名稱短於八個字元，則此參數長度為8個字節，以空格（0x20）填補右邊。
lua_extension_list_offset
SLI_PURGE未 使用，且 應設定為零。
lua_cobol_offset
MICROSOFT主機整合伺服器或 SNA 伺服器中®未使用 LUA，且應為零。
lua_sid
提供的參數。 指定會話標識碼，並由 SLI_OPEN 和 RUI_INIT傳回。 其他動詞會使用此參數來識別用於命令的會話。 如果其他動詞使用 lua_luname 參數來識別會話，請將 lua_sid 參數設定為零。
lua_max_length
SLI_PURGE未 使用，且 應設定為零。
lua_data_length
SLI_PURGE未 使用，且 應設定為零。
lua_data_ptr
發出 SLI_PURGE 時，此參數會指向要取消 之SLI_RECEIVE 動詞 VCB 的位置。
lua_post_handle
提供的參數。 如果事件要完成異步通知，則用於Microsoft Windows Server。 此變數包含要發出訊號的事件句柄或視窗句柄。
lua_th
SLI_PURGE未 使用，且 應設定為零。
lua_rh
SLI_PURGE未 使用，且 應設定為零。
lua_flag1
SLI_PURGE未 使用，且 應設定為零。
lua_message_type
SLI_PURGE未 使用，且 應設定為零。
lua_flag2
傳回的參數。 包含 LUA 所傳回之訊息的旗標。
lua_flag2.async
指出如果設定為 1，LUA 介面動詞動詞會以異步方式完成。
lua_resv56
保留且應設定為零。
lua_encr_decr_option
SLI_PURGE未 使用，且 應設定為零。
回傳代碼
LUA_OK
主要傳回碼;已順利執行動詞。
LUA_SEC_OK
次要傳回碼;LUA_OK沒有其他資訊存在。
LUA_PARAMETER_CHECK
主要傳回碼;因為參數錯誤而未執行動詞。
LUA_INVALID_LUNAME
次要傳回碼;指定了無效 lua_luname 。
LUA_BAD_SESSION_ID
次要傳回碼;在 VCB 中指定 了 無效lua_sid值。
LUA_BAD_DATA_PTR
次要傳回碼; lua_data_ptr 參數不包含有效的指標，或未指向讀取/寫入區段，而且需要提供的數據。
LUA_RESERVED_FIELD_NOT_ZERO
次要傳回碼;剛發出之動詞的保留參數不會設定為零。
LUA_INVALID_POST_HANDLE
次要傳回碼;針對使用事件做為異步張貼方法Microsoft Windows作系統，Windows LUA VCB 不包含有效的事件句柄。
LUA_VERB_LENGTH_INVALID
次要傳回碼;LUA 動詞是由 LUA 非預期的 lua_verb_length 值所發出。
LUA_STATE_CHECK
主要傳回碼;指令動詞未執行，因為發出狀態無效。
LUA_NO_SLI_SESSION
次要傳回碼;當發出命令時，會話未開啟或因為 SLI_CLOSE 或會話失敗而關閉。
LUA_NO_RECEIVE_TO_PURGE
次要傳回碼;當您發出SLI_PURGE時，沒有SLI_RECEIVE未完成。 造成問題的兩種情況之一：
SLI_RECEIVE 完成 之前，SLI_PURGE 完成處理。 您可以變更應用程式以處理此問題，因為它不是錯誤狀況。
lua_data_ptr參數未正確指向您想要清除的SLI_RECEIVE。
LUA_SLI_PURGE_PENDING
次要傳回碼;發出另一個SLI_PURGE時，SLI_PURGE仍在使用中。 一次只能有一個 SLI_PURGE 作用中。
LUA_SESSION_FAILURE
主要傳回碼;次要傳回碼中指定的錯誤狀況導致會話失敗。LUA_RECEIVED_UNBIND
次要傳回碼;主要邏輯單元 （PLU） 會在會話使用中時，將 SNA UNBIND 命令傳送至 LUA 介面。 因此，會話已停止。
LUA_LU_COMPONENT_DISCONNECTED
次要傳回碼;無法使用 LU 元件，因為它未正確連線。 請確定電源已開啟。
LUA_UNSUCCESSFUL
主要傳回碼;提供的動詞記錄有效，但動詞未順利完成。LUA_VERB_RECORD_SPANS_SEGMENTS
次要傳回碼;LUA VCB 長度參數加上區段位移超出區段結尾。
LUA_NOT_ACTIVE
次要傳回碼;發出 LUA 動詞命令時，在Microsoft主機整合伺服器或 SNA 伺服器內未使用 LUA。
LUA_NOT_READY
次要傳回碼;下列其中一項導致 SLI 工作階段暫時暫停：
已收到 SNA UNBIND 類型0x02命令，表示即將推出新的 BIND。 如果在開始SLI_OPEN完成後收到 UNBIND 類型 0x02 ，會話會暫停，直到收到 BIND、選擇性 CRV 和 STSN，以及收到 SDT 流程為止。 這些例程會重新進入，因為它們必須再次呼叫。 會話會在 SLI 處理 SDT 命令之後繼續。 如果在SLI_OPEN仍在處理時收到 UNBIND 類型 0x02 ，則主要傳回碼會SESSION_FAILURE，而不是LUA_STATUS。
收到 SNA CLEAR 導致暫停。 收到 SNA SDT 會導致工作階段繼續。
LUA_INVALID_PROCESS
次要傳回碼;發出要求單位介面 （RUI） 動詞的會話無法使用，因為另一個 OS/2 進程擁有會話。
LUA_LU_INOPERATIVE
次要傳回碼;RUI 嘗試停止會話時發生嚴重錯誤。 此 LU 無法供任何 LUA 要求使用，直到從主機收到啟動邏輯單元 （ACTLU） 為止。
LUA_CANCELED
主要傳回碼;次要傳回碼會提供取消命令的原因。LUA_TERMINATED
次要傳回碼;當動詞暫止時，會話已終止。 動詞程式已取消。
LUA_IN_PROGRESS
主要傳回碼;已收到異步命令，但尚未完成。LUA_COMM_SUBSYSTEM_ABENDED
主要傳回碼;表示下列其中一個條件：此交談所使用的節點遇到 ABEND。
交易程式 （TP） 與實體單位 （PU） 2.1 節點之間的連線已中斷（LAN 錯誤）。
TP 電腦上的 SnaBase 遇到 ABEND。
LUA_COMM_SUBSYSTEM_NOT_LOADED
主要傳回碼;處理動詞時，無法載入或終止必要的元件。 因此，無法進行通訊。 請連絡系統管理員以採取更正動作。LUA_INVALID_VERB_SEGMENT
主要傳回碼;VCB 延伸超過數據區段結尾。LUA_UNEXPECTED_DOS_ERROR
主要傳回碼;發出作系統呼叫之後，收到非預期的作系統傳回碼，並在次要傳回碼中指定。LUA_STACK_TOO_SMALL
主要傳回碼;應用程式的堆疊大小太小，無法執行動詞。 增加應用程式的堆疊大小。LUA_INVALID_VERB
主要傳回碼;動詞程式代碼或作業程序代碼或兩者都無效。 動詞未執行。
備註
SLI_PURGE 會取消具有等候條件 的SLI_RECEIVE 命令。
一般而言，如果SLI_RECEIVE太長而無法完成，就會發出SLI_PURGE。 若要取消SLI_RECEIVE，lua_data_ptr必須指向要取消的 SLI_RECEIVE VCB。 當SLI_PURGE成功取消SLI_RECEIVE時，SLI_RECEIVE的主要傳回碼將會設定為LUA_CANCELED。