IVdsIscsiTarget：：SetSharedSecret 方法 (vds.h)

[從 Windows 8 和 Windows Server 2012 開始，虛擬磁碟服務 COM 介面會由 Windows 記憶體管理 API 取代。

設定目標驗證啟動器時，用於 CHAP 驗證的目標 CHAP 共用密碼。

語法

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

[in] pTargetSharedSecret

包含共用秘密之VDS_ISCSI_SHARED_SECRET 結構的位址。如果 pSharedSecret 成員為 NULL 且 ulSharedSecretSize 為零， 則 SetSharedSecret 方法會清除任何現有的秘密。

[in] pwszInitiatorName

字串，指定共用秘密所要關聯的 iSCSI 名稱，如果秘密是起始端特定名稱，則為。傳遞的值會當做 CHAP 名稱使用。如果位址為 NULL ，則變更會套用至所有啟動器的預設秘密。

這個方法可以傳回標準 HRESULT 值，例如E_INVALIDARG或E_OUTOFMEMORY，以及 VDS 特定的傳回值。它也可以使用 HRESULT_FROM_WIN32 宏傳回已轉換的系統錯誤碼。錯誤可能來自 VDS 本身，或來自正在使用的基礎 VDS 提供者。可能的傳回值包括下列專案。

傳回碼/值	Description
S_OK	已成功設定共用秘密。
VDS_E_PROVIDER_CACHE_CORRUPT 0x8004241FL	提供者的快取已損毀。這表示提供者內的軟體或通訊問題，可快取連結裝置的相關信息。呼叫端可以使用 IVdsHwProvider：：Reenumerate 方法，後面接著 IVdsHwProvider：：Refresh 方法來還原快取。
VDS_E_OBJECT_DELETED 0x8004240BL	目標物件已不存在。
VDS_E_NOT_SUPPORTED 0x80042400L	此提供者不支援此作業或參數組合。
VDS_E_INITIATOR_SPECIFIC_NOT_SUPPORTED 0x80042707L	目標不支援起始端特定的共享秘密。

硬體提供者必須設定子系統本身，才能變更目標共享密碼。用於安全性的秘密不會由 VDS 保存，也不應該由本機電腦上的硬體提供者保存。硬體提供者應該以安全的方式將秘密傳輸至子系統，而子系統負責保存它。

某些 iSCSI 目標可能支援為每個啟動器設定不同的 CHAP 共用秘密。如果目標不支援起始端特定的秘密， 則 SetSharedSecret 的呼叫會傳回VDS_E_INITIATOR_SPECIFIC_NOT_SUPPORTED。