Metode IVdsIscsiInitiatorAdapter::LoginToTarget (vds.h)

[Dimulai dengan Windows 8 dan Windows Server 2012, antarmuka COM Layanan Disk Virtual digantikan oleh WINDOWS Storage Management API.]

Melakukan login manual ke target iSCSI.

Syntax

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-parameternya

[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 oleh 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 saat 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 pointer antarmuka. Namun, jika Wait mengembalikan nilai HRESULT kegagalan, atau jika parameter pHrResultWait menerima nilai HRESULT kegagalan, pointer 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.

Mengembalikan nilai

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 dasar yang sedang digunakan. Kemungkinan nilai yang dikembalikan termasuk yang berikut ini.

Mengembalikan kode/nilai	Description
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

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 R2 [hanya aplikasi desktop]
Platform Target	Windows
Header	vds.h
Library	Uuid.lib
Dapat didistribusikan ulang	VDS 1.1

Lihat juga

IVdsAsync

IVdsIscsiInitiatorAdapter

VDS_ISCSI_AUTH_TYPE

VDS_ISCSI_LOGIN_FLAG

VDS_ISCSI_LOGIN_TYPE