estrutura ISCSI_LoginOptions (iscsidef.h)
A estrutura ISCSI_LoginOptions define as características de uma sessão de logon. As rotinas de LoginToTarget_IN usam essas características definidas enquanto ela faz logon em um destino iSCSI.
Sintaxe
typedef struct _ISCSI_LoginOptions {
ULONG InformationSpecified;
ULONG HeaderDigest;
ULONG DataDigest;
ULONG MaximumConnections;
ULONG DefaultTime2Wait;
ULONG DefaultTime2Retain;
ULONG LoginFlags;
ULONG AuthType;
} ISCSI_LoginOptions, *PISCSI_LoginOptions;
Membros
InformationSpecified
Um bitmap que indica quais membros da estrutura ISCSI_LoginOptions contêm dados válidos. A tabela a seguir descreve os valores possíveis:
| bit | Descrição |
|---|---|
| ISCSI_LOGIN_OPTIONS_HEADER_DIGEST | O membro HeaderDigest especifica o tipo de resumo usado para garantir a integridade dos dados de cabeçalho. |
| ISCSI_LOGIN_OPTIONS_DATA_DIGEST | O membro DataDigest especifica o tipo de resumo usado para garantir a integridade dos dados de cabeçalho. |
| ISCSI_LOGIN_OPTIONS_MAXIMUM_CONNECTIONS | O membro MaximumConnections especifica o número máximo de conexões permitidas na sessão iSCSI. |
| ISCSI_LOGIN_OPTIONS_DEFAULT_TIME_2_WAIT | O membro DefaultTime2Wait especifica o tempo mínimo de espera, em segundos, antes que o iniciador tente reconectar ou reatribuir uma conexão que foi descartada. |
| ISCSI_LOGIN_OPTIONS_DEFAULT_TIME_2_RETAIN | O membro DefaultTime2Retain especifica o tempo máximo permitido para reatribuir comandos após a espera inicial indicada em DefaultTime2Wait. |
| ISCSI_LOGIN_OPTIONS_AUTH_TYPE | O membro AuthType especifica o tipo de autenticação que estabelece a sessão de logon. |
| ISCSI_LOGIN_OPTIONS_USERNAME | O nome de usuário a ser usado durante o logon. |
| ISCSI_LOGIN_OPTIONS_PASSWORD | A senha a ser usada durante o logon. |
HeaderDigest
Um valor ISCSI_DIGEST_TYPES que indica o método que o iniciador usa para verificar a integridade do resumo do cabeçalho em uma PDU de logon.
DataDigest
Um valor ISCSI_DIGEST_TYPES que indica o método que o iniciador usa para verificar a integridade do resumo de dados em uma PDU de logon.
MaximumConnections
Um valor entre 1 e 65535 que especifica o número máximo de conexões para dispositivos de destino que podem ser associadas a uma única sessão de logon. Um valor 0 indica que não há limite para o número de conexões.
DefaultTime2Wait
O tempo mínimo de espera, em segundos, antes que o iniciador tente reconectar ou reatribuir uma conexão (ou tarefa) que foi descartada após um encerramento ou redefinição de conexão inesperado. O iniciador e o destino negociam para determinar esse valor.
DefaultTime2Retain
O tempo máximo, em segundos, para reatribuir uma conexão após a espera inicial indicada em DefaultTime2Wait tiver decorrido. O iniciador e o destino negociam para determinar esse valor.
LoginFlags
Um OR bit a bit de sinalizadores de logon que definem determinadas características da sessão de logon. A tabela a seguir indica os valores que você pode atribuir a esse membro.
| Sinalizador de logon | Significado |
|---|---|
| ISCSI_LOGIN_FLAG_REQUIRE_IPSEC | A sessão de logon deve usar o protocolo IPSec. |
| ISCSI_LOGIN_FLAG_MULTIPATH_ENABLED | O software multicamada é instalado, portanto, o serviço iniciador iSCSI permite várias sessões para o mesmo destino. |
| ISCSI_LOGIN_FLAG_RESERVED1 | Somente uso interno da Microsoft. |
| ISCSI_LOGIN_FLAG_ALLOW_PORTAL_HOPPING | Se um portal de destino não estiver disponível para logon, o iniciador poderá "saltar" pela lista de portais de destino descobertos e que podem ser usados para operações de logon. Ou seja, o iniciador continuará tentando a lista de portais que estão disponíveis até encontrar um que possa ser usado para logon, para que ele possa fazer logon no portal de destino disponível. |
| ISCSI_LOGIN_FLAG_USE_RADIUS_RESPONSE | Use RADIUS para gerar a resposta CHAP. |
| ISCSI_LOGIN_FLAG_USE_RAIDUS_VERIFICATION | Use RADIUS para verificar a resposta CHAP. |
AuthType
Um valor ISCSI_AUTH_TYPES que indica o método de autenticação usado para estabelecer uma conexão de logon.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | iscsidef.h (include Iscsidef.h) |