IVdsServiceIscsi::RememberTargetSharedSecret method (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.]

Mengkomunikasikan rahasia bersama CHAP dari target ke layanan inisiator. Rahasia bersama ini digunakan selama login target saat target mengautentikasi inisiator.

Sintaks

HRESULT RememberTargetSharedSecret(
  [in] VDS_OBJECT_ID           targetId,
  [in] VDS_ISCSI_SHARED_SECRET *pTargetSharedSecret
);

Parameter

[in] targetId

VDS_OBJECT_ID target yang memiliki rahasia bersama yang ditentukan. Parameter ini diperlukan dan tidak dapat GUID_NULL.

[in] pTargetSharedSecret

Alamat struktur VDS_ISCSI_SHARED_SECRET yang berisi rahasia bersama CHAP.

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 yang mendasar yang sedang digunakan. Nilai yang mungkin dikembalikan termasuk yang berikut ini.

Mengembalikan kode/nilai	Deskripsi
S_OK	Rahasia bersama berhasil diingat.
VDS_E_INITIALIZED_FAILED 0x80042401L	VDS gagal diinisialisasi. Jika aplikasi memanggil metode ini sebelum layanan selesai diinisialisasi, metode diblokir hingga inisialisasi selesai. Jika inisialisasi gagal, kesalahan ini dikembalikan.

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

IVdsIscsiTarget::RememberInitiatorSharedSecret

IVdsIscsiTarget::SetSharedSecret

IVdsServiceIscsi

IVdsServiceIscsi::SetInitiatorSharedSecret

VDS_ISCSI_SHARED_SECRET