estrutura AddConnectionToSession_IN (iscsiop.h)

Artigo
08/07/2023

A estrutura AddConnectionToSession_IN contém dados de entrada para o método AddConnectionToSession , que é usado para adicionar uma nova conexão a uma sessão já existente.

Sintaxe

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;

Membros

UniqueAdapterId

Um inteiro de 64 bits que identifica exclusivamente um adaptador e uma instância carregada específica de um driver de miniporto de armazenamento que gerencia o adaptador. Esse identificador é exclusivo, não apenas no computador em que o adaptador está localizado, mas também em toda a rede.

UniqueSessionId

Um inteiro de 64 bits que identifica exclusivamente a sessão. Os métodos LoginToTarget e AddConnectionToSession retornam esse valor em seu parâmetro UniqueSessionId . Não confunda esse valor com os valores nos membros ISID e TSID.

SecurityFlags

Um OR bit a bit de sinalizadores que indicam os requisitos de segurança de um destino. Para obter uma lista de valores possíveis para esse membro, consulte SECURITY_FLAG_QUALIFIERS.

PortNumber

O número da porta da qual iniciar a sessão de logon de destino.

LoginOptions

Uma estrutura ISCSI_LoginOptions que descreve as características da sessão de logon de destino à qual uma conexão será adicionada.

TargetPortal

Uma estrutura ISCSI_TargetPortal que indica qual portal de destino usar para fazer a conexão adicional. O método AddConnectionToSession chama o método LoginToTarget para estabelecer a nova conexão. Se LoginToTarget falhar com um valor status de ISCSC_TARGET_MOVED_PERMANENTLY ou ISCSC_TARGET_MOVED_TEMPORARILY. TargetPortal indicará, na saída de AddConnectionToSession, o portal para o qual a operação de logon deve ser redirecionada. Para obter mais informações sobre os valores de ISCSC_TARGET_MOVED_PERMANENTLY e ISCSC_TARGET_MOVED_TEMPORARILY status, consulte ISCSI_STATUS_QUALIFIERS.

UsernameSize

O tamanho do nome de usuário, em bytes.

PasswordSize

O tamanho da senha, em bytes.

KeySize

O tamanho da chave pré-compartilhada, em bytes.

Key[1]

Uma matriz de caracteres de comprimento variável que especifica a chave pré-compartilhada associada ao endereço IP de destino. O número de elementos na matriz é especificado pelo campo KeySize.