SLI_BIND_ROUTINE
SLI_BIND_ROUTINE 동사는 MICROSOFT® WINDOWS® LUA(논리 단위 애플리케이션) 애플리케이션에 BIND 요청이 호스트에서 제공되었음을 알리고 사용자가 제공한 루틴이 요청을 검사하고 응답을 작성할 수 있도록 합니다.
다음 구조체는 SLI_BIND_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
제공된 매개 변수입니다. SLI(세션 수준 인터페이스) 동사에 대한 LUA_VERB_SLI 동사 코드를 포함합니다.
lua_verb_length
제공된 매개 변수입니다. LUA VCB의 길이(바이트)를 지정합니다. 발급되는 동사 레코드의 길이를 포함해야 합니다.
lua_prim_rc
동사가 완료될 때 LUA에서 설정한 기본 반환 코드입니다. 유효한 반환 코드는 발급된 LUA 동사에 따라 달라집니다.
lua_sec_rc
동사가 완료될 때 LUA에서 설정한 보조 반환 코드입니다. 유효한 반환 코드는 발급된 LUA 동사에 따라 달라집니다.
lua_opcode
제공된 매개 변수입니다. LUA_OPCODE_SLI_BIND_ROUTINE 발급할 동사에 대한 LUA 명령 코드(동사 작업 코드)를 포함합니다.
lua_correlator
제공된 매개 변수입니다. 동사를 다른 사용자가 제공한 정보와 연결하는 사용자가 제공한 값을 포함합니다. LUA는 이 정보를 사용하거나 변경하지 않습니다. 이 매개 변수는 선택적 요소입니다.
lua_luname
제공된 매개 변수입니다. Windows LUA 세션에서 사용하는 로컬 LU의 ASCII 이름을 지정합니다.
SLI_BIND_ROUTINE lua_sid 0인 경우에만 이 매개 변수가 필요합니다.
이 매개 변수는 8바이트 길이로, 이름이 8자보다 짧은 경우 오른쪽에 공백(0x20)이 채워집니다.
lua_extension_list_offset
SLI_BIND_ROUTINE 사용되지 않으며 0으로 설정해야 합니다.
lua_cobol_offset
Microsoft® Host Integration Server 또는 SNA Server의 LUA에서 사용되지 않으며 0이어야 합니다.
lua_sid
제공된 매개 변수입니다. 세션 식별자를 지정하고 SLI_OPEN 및 RUI_INIT 반환합니다. 다른 동사는 이 매개 변수를 사용하여 명령에 사용되는 세션을 식별합니다. 다른 동사에서 lua_luname 매개 변수를 사용하여 세션을 식별하는 경우 lua_sid 매개 변수를 0으로 설정합니다.
lua_max_length
SLI_BIND_ROUTINE 사용되지 않으며 0으로 설정해야 합니다.
lua_data_length
반환된 매개 변수입니다. 데이터 버퍼에 반환된 BIND RU(요청/응답 단위) 데이터의 길이를 지정합니다.
lua_data_ptr
SLI_BIND_ROUTINE 경우 이 매개 변수에는 BIND 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
예약된 및 는 0으로 설정해야 합니다.
lua_encr_decr_option
SLI_BIND_ROUTINE 사용되지 않으며 0으로 설정해야 합니다.
반환 코드
LUA_OK
기본 반환 코드입니다. 동사가 성공적으로 실행되었습니다.
LUA_SEC_OK
보조 반환 코드; LUA_OK 대한 추가 정보가 없습니다.
LUA_NEGATIVE_RSP
기본 반환 코드; LUA가 메시지에서 오류가 발견되어 PLU(기본 논리 단위)에서 받은 메시지에 부정적인 응답을 보내거나 애플리케이션이 체인의 끝부분이 도착한 체인에 부정적으로 응답했습니다.
설명
SLI_BIND_ROUTINE Windows LUA 애플리케이션이 호스트에서 수신된 BIND 요청을 검사하는 메커니즘을 제공합니다. Windows LUA는 사용자가 제공한 DLL(동적 연결 라이브러리)을 사용하여 BIND 요청이 수신되었음을 Windows LUA 애플리케이션에 알립니다. 그런 다음 사용자가 제공한 DLL 루틴은 BIND의 내용을 검사하고 요청에 대한 응답을 작성합니다.
루틴의 DLL 이름은 SLI_OPEN 동사 VCB의 확장으로 제공됩니다. lua_extension_list_offset 매개 변수는 VCB 시작부터 확장 목록의 이름까지 오프셋을 제공합니다.
Windows LUA 인터페이스는 VCB가 구조화된 스토리지 공간을 할당합니다. SLI_BIND_ROUTINE VCB에는 lua_th 및 lua_rh 포함되어 있습니다. BIND RU의 주소는 lua_data_ptr 지정되며 RU의 길이는 lua_data_length 지정됩니다.
SLI_BIND_ROUTINE Windows LUA로 돌아오면 SLI_BIND_ROUTINE 처리가 완료됩니다. BIND 응답은 BIND RU를 덮어써야 합니다. BIND가 수락되면 기본 반환 코드를 LUA_OK 설정해야 합니다. BIND가 거부되면 기본 반환 코드는 LUA_NEGATIVE_RSP 설정되어야 하며 BIND 버퍼에는 음수 센스 코드가 포함됩니다. lua_data_ptr 매개 변수는 수정하면 안 됩니다.
SLI_BIND_ROUTINE 음수 응답이 반환되면 SLI_OPEN 취소됩니다. SLI_OPEN lua_prim_rc LUA_SESSION_FAILURE 설정되고 lua_sec_rc LUA_NEG_RSP_FROM_BIND_ROUTINE 설정됩니다.
참고 항목
RUI_INIT
RUI_PURGE
RUI_READ
RUI_WRITE
SLI_OPEN
SLI_PURGE
SLI_RECEIVE
SLI_SEND