PERSISTENT_ISCSI_LOGIN_INFOA 구조체(iscsidsc.h)

PERSISTENT_ISCSI_LOGIN_INFO 구조에는 컴퓨터가 부팅된 후 Microsoft iSCSI 초기자 서비스에서 설정한 로그인 세션을 설명하는 정보가 포함되어 있습니다.

구문

typedef struct {
  CHAR                   TargetName[MAX_ISCSI_NAME_LEN + 1];
  BOOLEAN                IsInformationalSession;
  CHAR                   InitiatorInstance[MAX_ISCSI_HBANAME_LEN];
  ULONG                  InitiatorPortNumber;
  ISCSI_TARGET_PORTALA   TargetPortal;
  ISCSI_SECURITY_FLAGS   SecurityFlags;
  PISCSI_TARGET_MAPPINGA Mappings;
  ISCSI_LOGIN_OPTIONS    LoginOptions;
} PERSISTENT_ISCSI_LOGIN_INFOA, *PPERSISTENT_ISCSI_LOGIN_INFOA;

멤버

TargetName[MAX_ISCSI_NAME_LEN + 1]

초기자가 로그인할 대상의 이름을 나타내는 문자열입니다.

IsInformationalSession

TRUE로 설정하면 로그인 세션은 정보 용도로만 사용되며 로컬 컴퓨터에서 지정된 대상의 열거가 발생하지 않습니다. 정보 로그인 세션의 경우 대상의 LUN이 플러그 앤 플레이 관리자에 보고되지 않으며 대상에 대한 디바이스 드라이버가 로드되지 않습니다.

관리 애플리케이션은 SendScsiInquiry, SendScsiReportLuns 및 SendScsiReadCapcity 함수를 통해 시스템에서 열거하지 않는 대상에 계속 액세스할 수 있습니다.

FALSE를 설정하면 대상의 LUN이 플러그 앤 플레이 관리자에 열거형으로 보고됩니다.

InitiatorInstance[MAX_ISCSI_HBANAME_LEN]

대상에 로그인하는 데 사용되는 초기자의 이름을 나타내는 문자열입니다.

InitiatorPortNumber

세션 로그인이 설정된 HBA(Host-Bus 어댑터)의 포트 번호입니다. ISCSI_ANY_INITIATOR_PORT 값은 시작자의 포트가 현재 지정되지 않음을 나타냅니다.

TargetPortal

Microsoft iSCSI 초기자 서비스에서 대상에 로그온하는 데 사용하는 포털을 설명하는 ISCSI_TARGET_PORTAL 구조입니다.

SecurityFlags

로그인 연결의 보안 특성을 정의하는 비트맵입니다.

값	의미
ISCSI_SECURITY_FLAG_TUNNEL_MODE_PREFERRED	HBA(호스트 버스 어댑터) 초기자는 IPsec 터널 모드를 사용하여 대상 포털에 대한 TCP/IP 연결을 설정해야 합니다.
ISCSI_SECURITY_FLAG_TRANSPORT_MODE_PREFERRED	HBA 초기자는 IPsec 전송 모드를 사용하여 대상 포털에 대한 TCP/IP 연결을 설정해야 합니다.
ISCSI_SECURITY_FLAG_PFS_ENABLED	HBA 초기자는 IPsec이 필요한 경우 PFS(Perfect Forward Secrecy) 모드를 사용하도록 설정된 대상 포털에 대한 TCP/IP 연결을 설정해야 합니다.
ISCSI_SECURITY_FLAG_AGGRESSIVE_MODE_ENABLED	HBA 초기자는 공격적인 모드를 사용하도록 설정된 대상 포털에 대한 TCP/IP 연결을 설정해야 합니다.
ISCSI_SECURITY_FLAG_MAIN_MODE_ENABLED	HBA 초기자는 기본 모드를 사용하도록 설정된 대상 포털에 대한 TCP/IP 연결을 설정해야 합니다.
ISCSI_SECURITY_FLAG_IKE_IPSEC_ENABLED	HBA 초기자는 IKE/IPsec 프로토콜을 사용하여 대상 포털에 대한 TCP/IP 연결을 설정해야 합니다. 설정하지 않으면 대상에 로그인하는 데 IPsec이 필요하지 않습니다.
ISCSI_SECURITY_FLAG_VALID	다른 마스크 값은 유효합니다. 그렇지 않으면 보안 플래그가 지정되지 않습니다.

Mappings

대상, 논리 단위, HBA 및 도달한 버스에 대한 정보를 포함하는 ISCSI_TARGET_MAPPING 구조체에 대한 포인터입니다.

LoginOptions

영구 로그인 특성을 포함하는 ISCSI_LOGIN_OPTIONS 구조체입니다.

설명

PERSISTENT_ISCSI_LOGIN_INFO 구조는 ReportIScsiPersistentLogins 함수와 함께 사용하여 컴퓨터가 부팅된 후 Microsoft Discovery Service(iscsiexe.exe)가 자동으로 로그인 세션을 여는 대상 목록을 검색합니다.

참고

iscsidsc.h 헤더는 PERSISTENT_ISCSI_LOGIN_INFO 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

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

참고 항목

ISCSI_LOGIN_OPTIONS

ISCSI_TARGET_PORTAL

ReportIScsiPersistentLogins

SendScsiInquiry

SendScsiReadCapacity

SendScsiReportLuns