ISCSI_LOGIN_OPTIONS 구조체(iscsidsc.h)

  • 아티클

ISCSI_LOGIN_OPTIONS 구조체는 초기자가 로그인 세션의 특성을 지정하는 데 사용됩니다.

구문

typedef struct {
  ULONG                              Version;
  ISCSI_LOGIN_OPTIONS_INFO_SPECIFIED InformationSpecified;
  ISCSI_LOGIN_FLAGS                  LoginFlags;
  ISCSI_AUTH_TYPES                   AuthType;
  ISCSI_DIGEST_TYPES                 HeaderDigest;
  ISCSI_DIGEST_TYPES                 DataDigest;
  ULONG                              MaximumConnections;
  ULONG                              DefaultTime2Wait;
  ULONG                              DefaultTime2Retain;
  ULONG                              UsernameLength;
  ULONG                              PasswordLength;
  PUCHAR                             Username;
  PUCHAR                             Password;
} ISCSI_LOGIN_OPTIONS, *PISCSI_LOGIN_OPTIONS;

멤버

Version

구조체의 데이터를 정의하는 로그인 옵션 정의의 버전입니다. 이 멤버는 ISCSI_LOGIN_OPTIONS_VERSION 0으로 설정해야 합니다.

InformationSpecified

유효한 데이터가 포함된 ISCSI_LOGIN_OPTIONS 구조체의 부분을 나타내는 비트맵입니다.

bit 의미
ISCSI_LOGIN_OPTIONS_USERNAME
 로그인 연결을 만드는 데 사용할 사용자 이름을 지정합니다.
ISCSI_LOGIN_OPTIONS_PASSWORD
 로그인 연결을 만드는 데 사용할 암호를 지정합니다.
ISCSI_LOGIN_OPTIONS_HEADER_DIGEST
 헤더 데이터의 무결성을 보장하기 위해 사용할 다이제스트 유형을 지정합니다.
ISCSI_LOGIN_OPTIONS_DATA_DIGEST
 헤더 데이터의 무결성을 보장하기 위해 사용할 다이제스트 유형을 지정합니다.
ISCSI_LOGIN_OPTIONS_MAXIMUM_CONNECTIONS
 로그인 세션과 연결된 대상 디바이스에 대한 최대 연결 수를 지정합니다.
ISCSI_LOGIN_OPTIONS_DEFAULT_TIME_2_WAIT
 삭제된 연결을 다시 연결하거나 다시 할당하기 전에 대기할 최소 시간(초)을 지정합니다.
ISCSI_LOGIN_OPTIONS_DEFAULT_TIME_2_RETAIN
 DefaultTime2Wait에 표시된 초기 대기 후 명령을 다시 할당할 수 있는 최대 시간을 지정합니다.
ISCSI_LOGIN_OPTIONS_AUTH_TYPE
 로그인 세션을 설정하는 인증 유형을 지정합니다.

LoginFlags

로그인 세션의 특정 특성을 정의하는 로그인 플래그의 비트 OR입니다. 다음 표에서는 이 멤버에 할당할 수 있는 값을 나타냅니다.

플래그 의미
ISCSI_LOGIN_FLAG_RESERVED1
 내부용으로 예약된 속성입니다.
ISCSI_LOGIN_FLAG_ALLOW_PORTAL_HOPPING
 RADIUS 서버는 그렇게 되도록 구성된 경우 대상에 대한 포털 호핑 함수를 사용할 수 있습니다.
ISCSI_LOGIN_FLAG_REQUIRE_IPSEC
 로그인 세션은 IPsec 프로토콜을 사용해야 합니다.
ISCSI_LOGIN_FLAG_MULTIPATH_ENABLED
 다중 경로가 허용됩니다. 지정된 경우 iSCSI 초기자 서비스는 동일한 대상에 대한 여러 세션을 허용합니다. 동일한 대상에 여러 세션이 있는 경우 설치된 일종의 다중 경로 소프트웨어가 있어야 합니다. 그렇지 않으면 대상에서 데이터 손상이 발생합니다.

AuthType

인증 유형을 나타내는 ISCSI_AUTH_TYPES 형식의 열거자 값입니다.

HeaderDigest

헤더 데이터의 무결성을 보장하기 위한 다이제스트 형식을 나타내는 형식 ISCSI_DIGEST_TYPES 열거자 값입니다.

DataDigest

헤더가 아닌 데이터의 무결성을 보장하기 위한 다이제스트 유형을 나타내는 형식 ISCSI_DIGEST_TYPES 열거자 값입니다.

MaximumConnections

로그인 세션과 연결할 수 있는 대상 디바이스에 대한 최대 연결 수를 지정하는 1에서 65535 사이의 값입니다.

DefaultTime2Wait

삭제된 연결을 다시 연결하거나 다시 할당하기 전에 대기하는 최소 시간(초)입니다.

DefaultTime2Retain

DefaultTime2Wait에 표시된 초기 대기가 경과한 후 연결을 다시 할당할 수 있는 최대 시간입니다.

UsernameLength

Username 멤버에 지정된 사용자 이름의 길이(바이트)입니다.

PasswordLength

Password 멤버에 지정된 사용자 이름의 길이(바이트)입니다.

Username

로그인 세션을 설정하기 위해 인증할 사용자 이름입니다. 이 값이 문자열일 필요는 없습니다. 자세한 내용은 이 문서의 설명 섹션을 참조하세요.

Password

로그인 세션을 설정하기 위해 인증할 사용자 이름입니다. 이 값이 문자열일 필요는 없습니다. 자세한 내용은 이 문서의 설명 섹션을 참조하세요.

설명

초기자는 LoginIScsiTarget 루틴을 사용하여 로그인 세션을 만들 때 ISCSI_LOGIN_OPTIONS 구조를 사용합니다.

사용자 이름 및 암호 멤버는 iSCSI 인증에 사용되는 문자열 또는 이진 값입니다. 이 두 값의 정확한 의미와 함수는 사용되는 인증 유형에 따라 달라집니다. CHAP(Challenge Handshake Authentication Protocol)의 경우 Username 멤버의 값은 CHAP 이름이고 암호 멤버의 값은 대상의 공유 비밀입니다. Username에 지정된 값이 없으면 초기자 노드 이름이 CHAP 이름으로 사용됩니다.

인증 프로토콜에서 이러한 두 값이 문자열이어야 하는 경우 ANSI 문자열이어야 합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
머리글 iscsidsc.h

참고 항목

LoginIScsiTarget