Metode IVdsIscsiInitiatorAdapter::LoginToTarget (vds.h)

Artikel
03/08/2023

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh API Manajemen Penyimpanan Windows.]

Melakukan login manual ke target iSCSI.

Sintaks

HRESULT LoginToTarget(
  [in]  VDS_ISCSI_LOGIN_TYPE loginType,
  [in]  VDS_OBJECT_ID        targetId,
  [in]  VDS_OBJECT_ID        targetPortalId,
  [in]  VDS_OBJECT_ID        initiatorPortalId,
  [in]  ULONG                ulLoginFlags,
  [in]  BOOL                 bHeaderDigest,
  [in]  BOOL                 bDataDigest,
  [in]  VDS_ISCSI_AUTH_TYPE  authType,
  [out] IVdsAsync            **ppAsync
);

Parameter

[in] loginType

Jenis login yang akan dilakukan, dijumlahkan oleh VDS_ISCSI_LOGIN_TYPE.

[in] targetId

VDS_OBJECT_ID target untuk masuk. GUID_NULL menunjukkan bahwa inisiator adalah memilih portal.

[in] targetPortalId

VDS_OBJECT_ID portal target tempat operasi masuk dilakukan. GUID_NULL menunjukkan bahwa inisiator adalah memilih portal.

[in] initiatorPortalId

VDS_OBJECT_ID portal inisiator tempat operasi masuk dilakukan.

[in] ulLoginFlags

Bendera yang dijumlahkan dengan VDS_ISCSI_LOGIN_FLAG menentukan opsi masuk.

[in] bHeaderDigest

Jika TRUE, inisiator harus mengaktifkan hash header saat masuk ke portal target.

[in] bDataDigest

Jika TRUE, inisiator harus mengaktifkan hash data saat masuk ke portal target.

[in] authType

Jenis autentikasi yang diperlukan untuk masuk ke target, dijumlahkan oleh VDS_ISCSI_AUTH_TYPE.

[out] ppAsync

Alamat penunjuk antarmuka IVdsAsync . VDS menginisialisasi antarmuka yang dikembalikan. Penelepon harus merilis antarmuka. Gunakan antarmuka ini untuk membatalkan, menunggu, atau mengkueri status operasi. Jika IVdsAsync::Wait dipanggil pada antarmuka ini dan nilai HRESULT yang berhasil dikembalikan, antarmuka yang dikembalikan dalam struktur VDS_ASYNC_OUTPUT harus dirilis dengan memanggil metode IUnknown::Release pada setiap penunjuk antarmuka. Namun, jika Wait mengembalikan nilai HRESULT yang gagal, atau jika parameter pHrResultWait menerima nilai HRESULT yang gagal, penunjuk antarmuka dalam struktur VDS_ASYNC_OUTPUTadalah NULL dan tidak perlu dirilis. Anda dapat menguji keberhasilan atau kegagalan nilai HRESULT dengan menggunakan makro BERHASIL dan GAGAL yang ditentukan dalam Winerror.h.

Nilai kembali

Metode ini dapat mengembalikan nilai HRESULT standar, seperti E_INVALIDARG atau E_OUTOFMEMORY, dan nilai pengembalian khusus VDS. Ini juga dapat mengembalikan kode kesalahan sistem yang dikonversi menggunakan makro HRESULT_FROM_WIN32 . Kesalahan dapat berasal dari VDS itu sendiri atau dari penyedia VDS yang mendasar yang sedang digunakan. Nilai yang mungkin dikembalikan termasuk yang berikut ini.

Mengembalikan kode/nilai	Deskripsi
S_OK	Proses masuk berhasil diselesaikan.
VDS_E_ISCSI_LOGIN_FAILED 0x80042708L	Operasi lain sedang berlangsung. Operasi ini tidak dapat dilanjutkan hingga operasi sebelumnya selesai.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	vds.h
Pustaka	Uuid.lib
Redistribusi	VDS 1.1

Lihat juga

IVdsAsync

IVdsIscsiInitiatorAdapter

VDS_ISCSI_AUTH_TYPE

VDS_ISCSI_LOGIN_FLAG

VDS_ISCSI_LOGIN_TYPE