Metode IVdsServiceIscsi::SetInitiatorSharedSecret (vds.h)

  • Artikel

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

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

Sintaks

HRESULT SetInitiatorSharedSecret(
  [in] VDS_ISCSI_SHARED_SECRET *pInitiatorSharedSecret,
  [in] VDS_OBJECT_ID           targetId
);

Parameter

[in] pInitiatorSharedSecret

Alamat struktur VDS_ISCSI_SHARED_SECRET yang berisi rahasia bersama. Jika anggota pSharedSecret adalah NULL dan ulSharedSecretSize adalah nol, metode SetInitiatorSharedSecret menghapus rahasia yang ada. Jika parameter ini NULL dan parameter targetId tidak GUID_NULL, SetInitiatorSharedSecret menghapus hubungan antara inisiator dan target.

[in] targetId

VDS_OBJECT_ID target. Parameter ini diatur ke GUID_NULL jika rahasia bersama tidak spesifik untuk target.

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_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.
VDS_E_TARGET_SPECIFIC_NOT_SUPPORTED
0x80042706L
 Layanan inisiator tidak mendukung pengaturan rahasia bersama khusus target.

Keterangan

Inisiator dapat mendukung pengaturan rahasia bersama CHAP yang berbeda untuk setiap target.

Tidak ada cara untuk menentukan secara terprogram apakah inisiator mendukung rahasia khusus target. Jika panggilan ke SetInitiatorSharedSecret mengembalikan VDS_E_TARGET_SPECIFIC_NOT_SUPPORTED, panggil metode lagi, atur parameter targetId ke GUID_NULL.

Inisiator Perangkat Lunak Microsoft iSCSI tidak mendukung pengaturan rahasia khusus target.

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::IngatTargetSharedSecret

VDS_ISCSI_SHARED_SECRET