IcomLUO.CreateSession 메서드
새 LU0 세션을 만듭니다.
구문
void CreateSession(
string connectionSTR,
short initType,
ref System.Array data,
int timeout,
out object sessionHandle
)
매개 변수
매개 변수 | Description |
---|---|
connectionSTR |
새 세션의 연결 속성을 나타내는 NULL로 끝나는 문자열입니다. 문자열은 공백으로 구분된 "PROPERTY=VALUE"로 표시됩니다. 연결 속성 이름 및 값은 대/소문자를 구분하지 않습니다. 연결 속성에 대한 자세한 내용은 IcomLUO 세션 속성을 참조하세요. |
initType |
세션 초기화 유형을 포함합니다. 자세한 내용은 설명 섹션을 참조하십시오. |
data |
INITSELF 또는 SSCP 로그온 메시지를 포함하는 부호 없는 문자 형식의 배열을 포인터로 지정합니다. INIT_INITSELF 또는 INIT_LOGON 포함된 경우에만 initType 사용됩니다. |
timeout |
BIND 및 SDT 명령이 도착할 때까지 대기하는 시간(밀리초)입니다. SDT가 도착하기 전에 시간 제한이 만료되면 SNA 서버 LU가 해제되고 오류가 반환됩니다. 을 입력 timeout 하면 0xfffffff 무한 대기 시간이 발생합니다. |
sessionHandle |
이 메서드가 성공적으로 반환되면 기본 LU0 세션을 나타내는 comLU0 세션 개체에 대한 IUnknown 인터페이스에 대한 포인터를 포함합니다. 이 인터페이스에 대한 참조와 마찬가지로 세션 개체는 그대로 유지됩니다. 이 인터페이스는 세션과 함께 comLU0 개체에 연결하기 위해 IcomLU0.Connect 메서드에 전달될 수 있습니다. LU 속성이 지정되지 않은 경우 comLU0은 실행 중인 사용자 계정에 할당된 사용 가능한 가장 적합한 LU를 선택합니다. |
반환 값
다음 표에서는 CreateSession의 반환 코드에 대해 설명합니다.
값 | 설명 |
---|---|
S_OK | LU0 세션이 성공적으로 만들어졌습니다. LU 세션이 활성 상태이며 입력을 받을 준비가 된 것입니다. |
CLU0_S_SSCP_ACTIVE | LU0 세션이 성공적으로 만들어졌습니다. SSCP 세션이 활성 상태이며 입력을 받을 준비가 된 것입니다. 이 반환 코드는 가 로 설정된 경우에만 initType 유효합니다 INIT_SSCP . |
CLU0_E_NEG_RESPONSE | 호스트 또는 SNA 서버는 INITSELF에 부정적인 응답을 보냈습니다. 필요에 따라 호스트 또는 SNA 서버가 서식이 지정되지 않은 로그온 명령을 보냈을 수 있습니다. 이 값은 가 또는 INIT_LOGON 로 설정된 경우에만 initType 적용됩니다INIT_INITSELF . |
CLU0_E_BADPARM | connectionStr 에 잘못된 속성 설정이 포함되어 있습니다. |
CLU0_E_NOFREELU | 에 luname 지정된 LU는 SNA 서버 LU 풀입니다. 풀에는 현재 무료 RU가 없습니다. |
CLU0_E_LUINUSE | 에 luname 지정된 LU는 SNA 서버 LU입니다. 이 LU는 현재 다른 애플리케이션에서 사용되고 있습니다. |
CLU0_E_LUNOTFOUND | LU 또는 풀 이름이 없습니다. |
CLU0_E_TIMEDOUT | 지정된 시간 제한 내에 세션이 시작되지 않았습니다. |
CLU0_E_SESSION_FAILED | 세션이 활성화되지 않았고 TSS LU0 세션에 연결되지 않았습니다. 애플리케이션은 동일하거나 다른 연결 속성을 사용하여 새 세션을 만들거나 다른 TSS 세션 핸들에 연결해야 합니다. |
CLU0_E_ACCESSDENIED | 클라이언트의 사용자 계정에 요청된 LU 또는 풀을 사용할 수 있는 권한이 없습니다. |
CLU0_E_ALREADY_CONNECTED | comLU0 클라이언트가 이미 다른 세션에 연결되어 있습니다. |
CLU0_E_SYSERROR | 내부 오류로 인해 실패했습니다. |
설명
다음 표에는 에 대한 가능한 값이 포함되어 있습니다 initType
.
Name | 값 | Description |
---|---|---|
INIT_BIND | 0 | PLU에서 원치 않는 BIND 및 SDT를 기다립니다. |
INIT_SSCP | 1 | BIND 및 SDT가 도착할 때까지 기다리지만 애플리케이션이 SSCP 데이터 및 명령을 보낼 수 있도록 SSCP 세션에 대한 액세스를 허용합니다. |
INIT_INITSELF | 2 | 에 지정된 data INITSELF 명령을 보낸 후 BIND 및 SDT가 도착할 때까지 기다립니다. |
INIT_LOGON | 3 | 에 지정된 UNFORMATTED SSCP 로그온 메시지를 보낸 후 BIND 및 SDT가 data 도착할 때까지 기다립니다. |