estructura AddConnectionToSession_IN (iscsiop.h)

Artículo
08/07/2023

La estructura AddConnectionToSession_IN contiene datos de entrada para el método AddConnectionToSession , que se usa para agregar una nueva conexión a una sesión ya existente.

Sintaxis

typedef struct _AddConnectionToSession_IN {
  ULONGLONG          UniqueAdapterId;
  ULONGLONG          UniqueSessionId;
  ULONGLONG          SecurityFlags;
  ULONG              PortNumber;
  ISCSI_LoginOptions LoginOptions;
  ISCSI_TargetPortal TargetPortal;
  ULONG              UsernameSize;
  ULONG              PasswordSize;
  ULONG              KeySize;
  UCHAR              Key[1];
} AddConnectionToSession_IN, *PAddConnectionToSession_IN;

Miembros

UniqueAdapterId

Entero de 64 bits que identifica de forma única un adaptador y una instancia cargada determinada de un controlador de miniporte de almacenamiento que administra el adaptador. Este identificador es único, no solo en el equipo donde se encuentra el adaptador, sino también en toda la red.

UniqueSessionId

Entero de 64 bits que identifica de forma única la sesión. Los métodos LoginToTarget y AddConnectionToSession devuelven este valor en su parámetro UniqueSessionId . No confunda este valor con los valores de los miembros ISID y TSID.

SecurityFlags

OR bit a bit de marcas que indican los requisitos de seguridad de un destino. Para obtener una lista de los valores posibles para este miembro, consulte SECURITY_FLAG_QUALIFIERS.

PortNumber

Número del puerto desde el que se va a iniciar la sesión de inicio de sesión de destino.

LoginOptions

Estructura ISCSI_LoginOptions que describe las características de la sesión de inicio de sesión de destino a la que se agregará una conexión.

TargetPortal

Estructura ISCSI_TargetPortal que indica qué portal de destino se va a usar para realizar la conexión adicional. El método AddConnectionToSession llama al método LoginToTarget para establecer la nueva conexión. Si loginToTarget produce un error con un valor de estado de ISCSC_TARGET_MOVED_PERMANENTLY o ISCSC_TARGET_MOVED_TEMPORARILY. TargetPortal indicará, en la salida de AddConnectionToSession, el portal al que se debe redirigir la operación de inicio de sesión. Para obtener más información sobre los valores de estado de ISCSC_TARGET_MOVED_PERMANENTLY y ISCSC_TARGET_MOVED_TEMPORARILY, consulte ISCSI_STATUS_QUALIFIERS.

UsernameSize

Tamaño del nombre de usuario, en bytes.

PasswordSize

Tamaño de la contraseña, en bytes.

KeySize

Tamaño de clave previamente compartido, en bytes.

Key[1]

Matriz de caracteres de longitud variable que especifica la clave precompartida asociada a la dirección IP de destino. El campo KeySize especifica el número de elementos de la matriz.