struktur ISCSI_LoginOptions (iscsidef.h)
Struktur ISCSI_LoginOptions mendefinisikan karakteristik sesi masuk. Rutinitas LoginToTarget_IN menggunakan karakteristik yang ditentukan ini saat masuk ke target iSCSI.
Sintaks
typedef struct _ISCSI_LoginOptions {
ULONG InformationSpecified;
ULONG HeaderDigest;
ULONG DataDigest;
ULONG MaximumConnections;
ULONG DefaultTime2Wait;
ULONG DefaultTime2Retain;
ULONG LoginFlags;
ULONG AuthType;
} ISCSI_LoginOptions, *PISCSI_LoginOptions;
Anggota
InformationSpecified
Bitmap yang menunjukkan anggota struktur ISCSI_LoginOptions mana yang berisi data yang valid. Tabel berikut ini menjelaskan nilai yang mungkin:
| Bit | Deskripsi |
|---|---|
| ISCSI_LOGIN_OPTIONS_HEADER_DIGEST | Anggota HeaderDigest menentukan jenis hash yang digunakan untuk menjamin integritas data header. |
| ISCSI_LOGIN_OPTIONS_DATA_DIGEST | Anggota DataDigest menentukan jenis hash yang digunakan untuk menjamin integritas data header. |
| ISCSI_LOGIN_OPTIONS_MAXIMUM_CONNECTIONS | Anggota MaximumConnections menentukan jumlah maksimum koneksi yang diizinkan dalam sesi iSCSI. |
| ISCSI_LOGIN_OPTIONS_DEFAULT_TIME_2_WAIT | Anggota DefaultTime2Wait menentukan waktu minimum untuk menunggu, dalam hitungan detik, sebelum inisiator mencoba menyambungkan kembali atau menetapkan ulang koneksi yang terputus. |
| ISCSI_LOGIN_OPTIONS_DEFAULT_TIME_2_RETAIN | Anggota DefaultTime2Retain menentukan waktu maksimum yang diizinkan untuk menetapkan ulang perintah setelah penantian awal yang ditunjukkan dalam DefaultTime2Wait. |
| ISCSI_LOGIN_OPTIONS_AUTH_TYPE | Anggota AuthType menentukan jenis autentikasi yang menetapkan sesi masuk. |
| ISCSI_LOGIN_OPTIONS_USERNAME | Nama pengguna yang akan digunakan selama masuk. |
| ISCSI_LOGIN_OPTIONS_PASSWORD | Kata sandi yang akan digunakan selama masuk. |
HeaderDigest
Nilai ISCSI_DIGEST_TYPES yang menunjukkan metode yang digunakan inisiator untuk memverifikasi integritas hash header dalam PDU masuk.
DataDigest
Nilai ISCSI_DIGEST_TYPES yang menunjukkan metode yang digunakan inisiator untuk memverifikasi integritas hash data dalam PDU masuk.
MaximumConnections
Nilai antara 1 dan 65535 yang menentukan jumlah maksimum koneksi ke perangkat target yang dapat dikaitkan dengan satu sesi masuk. Nilai 0 menunjukkan bahwa tidak ada batasan jumlah koneksi.
DefaultTime2Wait
Waktu minimum untuk menunggu, dalam hitungan detik, sebelum inisiator mencoba menyambungkan kembali atau menetapkan ulang koneksi (atau tugas) yang telah terputus setelah penghentian atau reset koneksi yang tidak terduga. Inisiator dan target bernegosiasi untuk menentukan nilai ini.
DefaultTime2Retain
Waktu maksimum, dalam detik, untuk menetapkan ulang koneksi setelah penantian awal yang ditunjukkan dalam DefaultTime2Wait telah berlalu. Inisiator dan target bernegosiasi untuk menentukan nilai ini.
LoginFlags
Bitwise ATAU bendera masuk yang menentukan karakteristik tertentu dari sesi masuk. Tabel berikut menunjukkan nilai yang bisa Anda tetapkan untuk anggota ini.
| Bendera masuk | Makna |
|---|---|
| ISCSI_LOGIN_FLAG_REQUIRE_IPSEC | Sesi masuk harus menggunakan protokol IPSec. |
| ISCSI_LOGIN_FLAG_MULTIPATH_ENABLED | Perangkat lunak multipathing diinstal, sehingga layanan inisiator iSCSI memungkinkan beberapa sesi ke target yang sama. |
| ISCSI_LOGIN_FLAG_RESERVED1 | Penggunaan internal Microsoft saja. |
| ISCSI_LOGIN_FLAG_ALLOW_PORTAL_HOPPING | Jika portal target tidak tersedia untuk masuk, inisiator dapat "melompat" melalui daftar portal target yang ditemukan dan yang dapat digunakan untuk operasi masuk. Artinya, inisiator akan terus mencoba daftar portal yang tersedia sampai menemukan yang dapat digunakan untuk masuk, sehingga kemudian dapat masuk ke portal target yang tersedia. |
| ISCSI_LOGIN_FLAG_USE_RADIUS_RESPONSE | Gunakan RADIUS untuk menghasilkan respons CHAP. |
| ISCSI_LOGIN_FLAG_USE_RAIDUS_VERIFICATION | Gunakan RADIUS untuk memverifikasi respons CHAP. |
AuthType
Nilai ISCSI_AUTH_TYPES yang menunjukkan metode autentikasi yang digunakan untuk membuat koneksi masuk.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header | iscsidef.h (termasuk Iscsidef.h) |