Metode IVdsIscsiTarget::SetSharedSecret (vdshwprv.h)

Artikel
03/08/2023

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

Menetapkan rahasia bersama CHAP target yang digunakan untuk autentikasi CHAP saat target mengautentikasi inisiator.

Sintaks

HRESULT SetSharedSecret(
  [in] VDS_ISCSI_SHARED_SECRET *pTargetSharedSecret,
  [in] LPWSTR                  pwszInitiatorName
);

Parameter

[in] pTargetSharedSecret

Alamat struktur VDS_ISCSI_SHARED_SECRET yang berisi rahasia bersama. Jika anggota pSharedSecret adalah NULL dan ulSharedSecretSize adalah nol, metode SetSharedSecret menghapus rahasia yang ada.

[in] pwszInitiatorName

String yang menentukan nama iSCSI tempat rahasia bersama akan dikaitkan, jika rahasianya khusus inisiator. Nilai yang diteruskan digunakan sebagai nama CHAP. Jika alamat NULL , perubahan berlaku untuk rahasia default untuk semua inisiator.

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 disetel.
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	Cache penyedia rusak. Ini menunjukkan masalah perangkat lunak atau komunikasi di dalam penyedia yang menyimpan informasi tentang perangkat yang terpasang. Pemanggil dapat menggunakan metode IVdsHwProvider::Reenumerate diikuti dengan metode IVdsHwProvider::Refresh untuk memulihkan cache.
VDS_E_OBJECT_DELETED 0x8004240BL	Objek target tidak lagi ada.
VDS_E_NOT_SUPPORTED 0x80042400L	Operasi atau kombinasi parameter ini tidak didukung oleh penyedia ini.
VDS_E_INITIATOR_SPECIFIC_NOT_SUPPORTED 0x80042707L	Target tidak mendukung rahasia bersama khusus inisiator.

Keterangan

Penyedia perangkat keras harus mengonfigurasi subsistem itu sendiri untuk mengubah rahasia bersama target. Rahasia yang digunakan untuk keamanan tidak dipertahankan oleh VDS juga tidak boleh dipertahankan oleh penyedia perangkat keras di komputer lokal. Penyedia perangkat keras harus mengirimkan rahasia ke subsistem dengan cara yang aman, dan subsistem bertanggung jawab untuk mempertahankannya.

Beberapa target iSCSI dapat mendukung pengaturan rahasia bersama CHAP yang berbeda untuk setiap inisiator. Jika target tidak mendukung rahasia khusus inisiator, panggilan ke SetSharedSecret akan mengembalikan VDS_E_INITIATOR_SPECIFIC_NOT_SUPPORTED.

Persyaratan

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

Lihat juga

IVdsIscsiTarget

IVdsIscsiTarget::RememberInitiatorSharedSecret

IVdsIscsiTarget::SetSharedSecret

IVdsServiceIscsi::SetInitiatorSharedSecret

VDS_ISCSI_SHARED_SECRET