dsmQuerySessInfo

온라인 편집

dsmQuerySessInfo 함수 호출은 dsmHandle에서 지정된 세션의 조작과 관련된 정보를 위해 IBM® Storage Protect 에 대한 조회 요청을 시작합니다. 입력된 사용 가능한 모든 세션 관련 정보와 함께 ApiSessInfo 유형의 구조가 호출에서 전달됩니다. 이 호출은 dsmInitEx 호출에 성공한 후 시작됩니다.

ApiSessInfo 구조에 리턴되는 정보는 다음과 같습니다.

  • 서버 정보: 포트 번호, 날짜 및 시간, 유형
  • 클라이언트 기본값: 애플리케이션 유형, 삭제 권한, 구분 기호 및 트랜잭션 한계
  • 세션 정보: 로그인 ID 및 소유자
  • 정책 데이터: 도메인, 활성 정책 세트 및 보존 유예 기간

전달되는 구조의 컨텐츠 및 구조 내의 각 필드에 대한 정보는 API 유형 정의 소스 파일 을 참조하십시오.

구문

dsInt16_t dsmQuerySessInfo  (dsUint32_t         dsmHandle,
   ApiSessInfo   *SessInfoP);

매개변수

dsUint32_t dsmHandle (I)
이 호출을 이전의 dsmInitEx 호출과 연관시키는 핸들입니다.
ApiSessInfo *SessInfoP (I/O)
이 매개변수는 API가 입력하는 구조의 주소를 전달합니다. 애플리케이션 클라이언트가 구조에 대한 스토리지를 할당하고 사용되는 구조의 버전을 나타내는 필드 항목을 채웁니다. 성공적인 리턴에서는 구조의 필드에 적절한 정보가 작성되어 있습니다. adsmServerName 은 IBM Storage Protect 서버에서 define server 명령에 지정된 이름입니다. archiveRetentionProtection 필드가 참인 경우 서버에 보존 보호를 사용할 수 있습니다.

리턴 코드

리턴 코드 번호는 괄호 ( ) 안에 표시됩니다.

표 1. 다음에 대한 반환 코드 dsmQuerySessInfo
리턴 코드 설명
DSM_RC_NO_SESS_BLK (2006) 서버 세션 블록 정보가 없습니다.
DSM_RC_NO_POLICY_BLK (2007) 사용 가능한 서버 정책 정보가 없습니다.
DSM_RC_WRONG_VERSION_PARM (2065) 애플리케이션 클라이언트의 API 버전은 IBM Storage Protect 라이브러리 버전과 다릅니다.