다음을 통해 공유

Set_Conversation_Security_Password(CPI-C)

  • 아티클

호출된 프로그램에 액세스하는 데 필요한 암호를 지정하기 위해 호출 프로그램에서 Set_Conversation_Security_Password 호출(함수 이름 cmscsp)을 실행합니다.

구문

  
CM_ENTRY Set_Conversation_Security_Password(   
  unsigned char FAR *conversation_ID,    
  unsigned char FAR *security_password,    
  CM_INT32 FAR *security_password_length,    
  CM_INT32 FAR *return_code              
);

매개 변수

conversation_ID
제공된 매개 변수입니다. 대화의 식별자를 지정합니다. 이 매개 변수의 값은 Initialize_Conversation 반환되었습니다.

security_password
제공된 매개 변수입니다. 파트너 프로그램에 액세스하는 데 필요한 암호를 지정합니다. 이 매개 변수는 최대 8개의 ASCII 문자로 구성된 문자열이며 대/소문자를 구분합니다. 파트너 프로그램에 대해 구성된 사용자 식별자의 암호와 일치해야 합니다.

허용되는 문자는 다음과 같습니다.

  • 대문자 및 소문자입니다.

  • 0에서 9까지의 숫자입니다.

  • 공백을 제외한 특수 문자입니다.

    CPI-C 자동 로그온 기능을 사용하는 경우 이 매개 변수를 MS$SAME 문자열로 설정해야 합니다. 자세한 내용은 이 항목의 뒷부분에 있는 설명 섹션을 참조하세요.

    security_password_length
    제공된 매개 변수입니다. security_password 길이를 지정합니다. 범위는 0에서 8까지입니다.

    CPI-C 자동 로그온 기능을 사용하는 경우 이 매개 변수를 7로 설정해야 합니다. 자세한 내용은 이 항목의 뒷부분에 있는 설명 섹션을 참조하세요.

    return_code
    이 호출에서 반환된 코드입니다. 유효한 반환 코드는 이 항목의 뒷부분에 나와 있습니다.

반환 코드

CM_OK
기본 반환 코드; 호출이 성공적으로 실행되었습니다.

CM_PROGRAM_PARAMETER_CHECK
기본 반환 코드; 다음 중 하나가 발생했습니다.

  • conversation_ID 지정한 값이 잘못되었습니다.

  • security_password_length 지정한 값이 범위를 벗어났습니다.

    CM_PROGRAM_STATE_CHECK
    기본 반환 코드; 다음 중 하나가 발생했습니다.

  • 대화가 INITIALIZE 상태가 아닙니다.

  • 대화 보안 유형이 CM_SECURITY_PROGRAM 설정되지 않았습니다.

상태 변경

대화는 INITIALIZE 상태여야 합니다.

상태 변경은 없습니다.

설명

이 호출은 대화 보안 유형이 CM_SECURITY_PROGRAM 또는 CM_SECURITY_SAME 경우에만 대화에 영향을 미칩니다. Initialize_Conversation 지정한 측면 정보에서 초기 암호를 재정의합니다. 할당이 실행된 후에는 이 호출을 실행할 수 없습니다.

할당에서 생성된 할당 요청이 LU(파트너 논리 단위)로 전송될 때까지 잘못된 암호가 검색되지 않습니다. 오류는 후속 호출에서 호출 프로그램에 반환됩니다.

CPI-C 애플리케이션에 대한 자동 로그온은 Host Integration Server에서 지원됩니다. 이 기능을 사용하려면 네트워크 관리자의 특정 구성이 필요합니다. CPI-C 애플리케이션은 SNA 서버의 클라이언트에서 LAN 쪽에서 호출되어야 합니다. 클라이언트는 Microsoft Windows 도메인에 로그인해야 하지만 호스트 통합 서버 CPI-C API를 지원하는 모든 플랫폼일 수 있습니다.

클라이언트 애플리케이션은 특수 하드 코딩된 CPI-C 사용자 이름 MS$SAME 및 암호 MS$SAME와 함께 프로그램 수준 보안을 사용하도록 코딩됩니다. 이 세션 할당이 클라이언트에서 SNA 서버로 흐르면 SNA 서버는 클라이언트가 로그인된 Windows 계정에 해당하는 호스트 계정 및 암호를 조회하고 호스트 계정 정보를 호스트에 보내는 APPC 연결 메시지로 대체합니다.